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® A remote service facility (RSF) unit is integrated into the operating system of the host system being 
supported. The RSF unit utilizes a standard generic menu interface system (GMIS) unit through which a user 
can enter different types of commands which results in the display of a number of menu sequences for 
configuring how the different independently controllable components of the RSF unit will operate in performing 
remote support functions. The components include a problem detection and reaction component, a system 
action component and a callback component, each of which operatively couple to the GMIS unit. The 
components are integrated in a predetermined manner so that collectively, they carry out remote support 
according to the way in which they were configured. 
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Additionally, the configuration means of the problem detection and reaction component can be used to 
set a clean time parameter which establishes the time interval at which the daemon process cleans its 
associated database files to free them of stale messages. This parameter can be used in conjunction with 
another parameter (keepmax) for setting an upper limit on how many copies of a given message are to be 

5 stored in an associated storage message database file managed by the daemon process for each source 
being monitored thereby reducing host system storage requirements. 

Also, in accordance with the present invention, the configuration means can be used to configure the 
problem detection and reaction component to enable different actions to be initiated in response to 
detecting an over threshold condition on a particular source. This decouples the problem detection and 

70 reaction component from the operation of the system action component thereby providing greater flexibility 
In prescribing what actions should be taken in a given case as well as the option to take no action in certain 
cases. Thus, a variety of different options can be configured. In the preferred embodiment, this includes 
callout via local or through shared communications facilities and mail notification actions. 

The configuration means of the system action component of the preferred embodiment can be used to 

75 support the actions mentioned above through the facilities of the host system. Additionally, such means can 
be used to support the support notification actions for standalone and cluster host configurations (i.e.. 
cluster client and cluster server). In the standalone configuration, the callout function is carried out by a 
daemon process which manages the execution of callout requests entered into a callout manager queue 
using the communication facilities (modem) of the host system. In the cluster configuration, the callout 

20 function is carried out through shared communication facilities using cluster client/server software facilities 
installed on the different systems which make up the cluster. An additional daemon process is used to 
manage such shared communications requests. 

Also. the managing of the callout function in terms of how it Is executed can also be configured. It is 
possible to select the type of response center communications protocol to be used in communicating a 

25 callout action and provide the appropriate parameters to a response center such as unique host system 
identification information for enabling the selected remote center to respond properly to such callout 
request a comprehensive list of response center phone numbers to be tried in sequence until a successful 
connection is made, remote password information to be used by the center in responding to the callout and 
an electronic mail address to which notification of the callout action is to be sent. 

30 Also, in accordance with the present invention, the configuration means of the system action component 
can be used in specifying a comprehensive set of communication parameters for establishing a commu- 
nications link via a large number of different types of modems such as acknowledgment response (OK) byte 
strings and connection byte strings which can vary from link to link. The configuration means further 
enables configuring other parameters such as the number of tries to be made for each phone number, the 

35 delay between busy tries and communications (modem) delays. This capability provides an effective way of 
matching the callout action to the type of host system resources to be utilized in making and responding to 
the callout function in an efficient and expeditious manner. 

In accordance with the present Invention, the configuration means of the callback component enables 
remote access by a response center, the establishment of permissions to be granted to a remote user and 

40 selection of a number of different types of session scripting or monitoring options for enabling an 
administrator of the host system to view all of the actions being taken by a remote user. In this way. it is 
possible to maintain the security and integrity of host system data as well as capturing for later viewing, all 
actions taken during a given session conducted in the performance of the remote support function. A further 
feature of the callback component is a hot key capability which allows the administrator to immediately 

45 terminate any current session by the remote user thereby providing further security control. 

The above and other objects of the present invention are achieved in the illustrative embodiment 
described hereinafter. Novel features which are believed to be characteristic of the invention, both as to its 
organization and method of operation, together with further objects and advantages, will be better 
understood from the following description when considered in connection with the accompanying drawings. 

50 It is expressly understood, however, that these drawings are for the purpose of illustration and description 
only and are not intended as definition of the limits of the present invention. 

BRIEF DESCRIPTION OF THE DRAWINGS 

55 Figure 1 Is a block diagram of a standalone configured host system which Incorporates the remote 

support facility of the present invention. 

Figure 2 is a block diagram of cluster configured host systems which Incorporate the remote support 
facility of the present Invention. 
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Figure 3 is a block diagram of the remote support facility of the present invention. 

Figures 4a through 4cl illustrate in greater detail, the different components of Figure 3. 

Figures 5a through 5e illustrate in greater detail, the formatting of the different databases and sources 
of the problem detection and reaction component of Figure 4a. 
5 Figure 6 illustrates the organization of the menu system utilized by the generic menu interface system 

of Figure 1 in accordance with the present invention. 

Figure 7a illustrates a sample sequence of configuration steps. 

Figure 7b illustrates in greater detail, the install operation of Figure 7a. 

Figure 7c illustrates in greater detail, the source configuration operations of Figure 7a. 
10 Figures 7d1 through 7d4 illustrates in greater detail, the callout configuration operation of Figure 7a. 

Figure 7e illustrates in greater detail, the set system identifier operation of Figure 7d. 

Figure 7f illustrates in greater detail, the configure callback operation of Figure 7a. 

Figure 7g illustrates in greater detail, the configure monitoring/mirroring operation of Figure 7f. 

Figure 7h illustrates in greater detail, the configure diagnostic operation of Figure 7a. 
76 Figure 7i illustrates in greater detail, the configure daemons operation of Figure 7a. 

Figures 8a through 8t illustrate menus utilized in carrying out the configuration operations of Figures 7a 
through 7d. 

Figures 9a through 9c illustrate menus utilized in carrying out the configuration operations of Figures 7f 
and 7g. 

20 Figures 10a through lOd illustrate menus utilized in carrying out the configuration operations of Figures 

7h and Ti. 

Figures 11a through lid are flow diagrams used in describing the operation of the problem detection 
and reaction component of Figure 4a. 

Figures 12a through 12d and 13a through 13d are flow diagrams used in describing different functions 
25 performed by the callback component of Figure 4c. 

DESCRIPTION OF HOST SYSTEM OF FIGURE 1 

Figure 1 illustrates the use of the remote service facility (RSF) unit of the present invention in a 

30 standalone system environment. As shown, this environment includes a host system 10 coupled to a 
communications link via a modem 12 for establishing dial out access to a remotely located response center 
14 or a technical assistance center (TAG) as well as dial in access for carrying out support operations. As 
shown, the host system 10 includes a host computer system 10-2 which operatively couples to a main 
memory 10-3 and to input/output storage devices, such as disk files 10-16. The disk files 10-16 provide 

35 storage for the different files utilized by the RSF unit of the present invention. For the purpose of the 
present invention, the host computer system is conventional in design and may take the form of the DPX/20 
system marketed by Bull HN Information Systems Inc. 

A user can directly access the computer system 10-2 through a terminal or local console 10-14 while a 
system administrator is able to access system 10-2 through a administration terminal or administration 

40 console 10-12. As shown, each of the consoles 10-12 and 10-14 Includes a display device, keyboard and 
optionally, a pointing device such as a mouse. 

The system 10-2 is operated under the control of a UNIX based software system 10-4 which includes a 
UNIX based operating system or kernel which controls the computer system 10-2 and provide a system call 
interface to all of the programs running on the system. The system 10-4 also includes a library for storing 

45 procedures for processing such system calls (one procedure per call) and a large number of standard utility 
programs such as the command processor or shell, compilers, text processing programs and file manipula- 
tion utilities. Additionally, the host system includes a generic menu interface system (GMIS) unit 10-8 which 
operates as a resident command building facility. For the purpose of the present invention, the unit 10-8 can 
be considered conventional in design. In the preferred embodiment, GMIS takes the form of the System 

50 Management Interface Tool described in the publication entitled. "Bull DPX/20 General Programming 
Concepts* dated April, 1993. published by Bull HN Information Systems Inc., order reference SC23-2205. 

In accordance with the present invention, the system 10 includes a remote services facility (RSF) unit 
10-10 of the present invention which has an interface to GMIS unit 10-8 and to the UNIX system 10-4. The 
RSF unit 10-10 operates to detect problems occurring in the host system, to report such problems to a 

55 response center via autodial out and to provide a secure operating environment for callback responses 
made via dial-in access by such response center utilizing the host system facilities. 

In addition to operating in a standalone configuration, the RSF unit 10-10 also operates in a cluster 
configuration of client and server host systems such as that shown in Figure 2. As shown, each host system 

6 
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connects to a local area network (LAN) or wide area network (WAN) system. In this configuration, the 
modem 12 is shared among alt of the host systems using the network communication facilities of the 
LANA/VAN system and remote call procedures (RPCs) provided as part of the UNIX system 10-4 utilizing 
the TCP/IP network software protocol. Each host system also includes its own complement of consoles, 
5 disk devices, etc.. not shown. 

As indicated and described in further detail herein, a different component module (netact'netacd) is 
configured for client host systems and the server host system directly connected to the modem 12 which is 
to be shared by the client host systems. In this system configuration, a callout request originating on a 
client host system is able to utilize the server host system via the LANA/VAN to make the callout request. 

10 

DESCRIPTION OF RSF UNIT 10-10 

Figure 3 shows in block diagram form, the packaging structure and major components of the RSF unit 
10-10. As shown, the RSF unit 10-10 includes the following four subpackages: a problem detection and 
reaction subpackage 10-100; a system action subpackage 10-200. a cluster services subpackage 10-300 
and a callback environment subpackage 10-400. As a function of the type of system installation, different 
ones of these subpackages are installed into the host system 10-2. The below table shows which 
subpackages are installed for the standalone, cluster client and cluster server system configuration 
illustrated in Figures 1 and 2. 

TABLE 



Type of System Installation 


Problem Detection and 
Reaction Subpkg. 


Callback 
Subpkg. 


System Action 
(Autodial) Subpkg. 


Cluster 
Subpkg. 


Standalone 


X 


X 


X 




Cluster Client 


X 


X 




X 


Cluster Server 


X 


X 


X 


X 



As indicated by the table, in the standalone system of Figure 1, subpackages 10-100, 10-200 and 10- 
400 are installed. In each client system of Figure 2. subpackages 10-100. 10-200 and 10-300 are installed. 
In the server system of Figure 2, all of the subpackages 10-100. 10-200, 10-300 and 10-400 are installed. 

Each of the subpackages will now be considered in greater detail. As shown in Figure 3, subpackage 
10-100 includes the problem detection and reaction component of unit 10-10. This component operatively 
couples to GMIS unit 10-8. to administrator console 10-14 and to local console 10-12 for receiving 
commands therefrom. As shown, component 10-100 provides output action signals to system action 
subpackage 10-200 and cluster subpackage 10-300. This component can be configured to monitor different 
types of sources such as the host system log error file and any ASCII log file generated by any application 
running on host system 10-2. 

The component 10-100 includes a plurality of databases and log files represented by block 10-102 
which are accessed via routines contained within a RSF library 10-104. A number of command programs 
included within block 10-106 execute the different types of commands received from GMIS unit 10-8 and 
consoles 10-12 and 10-14 utilizing the library routines of block 10-104. Additionally, component 10-100 
includes a rsfd daemon 10-110 which also accesses certain routines of library 10-104 for performing certain 
operations such as diagnostic callout operations discussed herein. The rsfd daemon 10-110 monitors the 
configured sources to detect when messages reach over threshold conditions and executes those types of 
actions specified for such sources. 

The subpackage 10-200 includes the system action component of RSF unit 10-10. As shown, the 
system action subpackage 10-200 operatively couples to rsfd daemon 10-100 to modem 12 and to cluster 
subpackage 10-300. In the preferred embodiment, component 10-200 includes a mail action subcomponent 
10-202 and an autodlal/callout subcomponent 10-204. The subcomponent 10-204 Includes a callout 
manager module 10-210. a call force module 10-212. a call configuration file 10-216. a call action module 
10-218 and a callout/'callbin module 10-220 which operatively couple to each other as indicated in Figure 3. 
When configured, the mall action subcomponent 10-202 operates to carry out electronic mail notification 
through the E-Mail facilities of the UNIX-based system 10-4. The callout subcomponent 10-204 when 
configured operates to carry out callout action operations Initiated by the problem detection and reaction 
component 10-100 through modem 12 via module 10-220. 
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The cluster subpackage 10-300 includes the cluster services component of RSF unit 10-10. The cluster 
subpackage 10-300 operatively couples to rsfd daemon 10-110» the RPC and TCP/IP connnnunication 
facilities of system 10-4 and to callout subcomponent 10-204 as shown. In the preferred embodiment, the 
component 10-300 includes a call force module 10-312, a callact module 10-318 and the netactd/netcall 

5 modules of block 10-320. To accommodate different installation requirements, modules 10-212, 10-214, 10- 
216 and 10-218 are also included in component 10-300 and correspond to modules 10-312. 10-314, 10-316 
and 10-318- The modules netactd and netcall are used in cluster server and cluster client systems, 
respectively. When configured, the component 10-300 operates to carry out callout operations for cluster 
system configurations via the local area network and operating system communication facilities illustrated in 

10 Figure 2. 

The callback subpackage 10-400 includes the callback component of RSF unit 10-10. The callback 
subpackage 10-400 operatively couples to the modem 12, GMIS unit 10-8 and to console 10-12. As shown, 
component 10-400 includes a mirroring subcomponent 10-402 and a permission control subcomponent 10- 
422. The subcomponent 10-402 can be configured to carry out a plurality of different mirroring and scripting 
15 operations which enable an administrator to observe all of the operations carried out by a remote user who 
dials into " the host system 10-2 from TAG 16. The permission control subcomponent 10-420 can be 
configured as desired for security purposes to control remote user access to host system facilities. 

PROBLEM DETECTION AND REACTION 

20 

COMPONENT 10-100 - Figure 4a 

Figure 4a shows in greater detail, the problem detection and reaction component 10-100 of the present 
invention. The block diagram indicates the operative coupling between the different programs and files 

25 utilized by the component 10-100. As shown, block 10-106 includes command programs 10-1 06a through 
10-106k and files 10-1061 and 10-106m. These programs are invoked through a command line generated 
either via GMIS unit 10-8 or console 10-12. With the exception of command program 10-1 06a, these 
programs access one or more routines contained in RSF library 10-104 as a function of the parameters 
contained in the command line. The program 10-1 06a also receives an input from the system 10-4 and the 

30 user generated configuration file 10-1 06m. As discussed herein, program 10-1 06a generates the initialization 
file 10-1061 which can be used by programs 10-1 06b, 10-1 06c and 10-106e. 

As shown, library 10-104 includes a plurality of routines 10-1 04a through 10-1 04k which will be 
discussed in greater detail herein. The routines 10-104a through 10-104k described in greater detail in the 
appendix are used to manage the contents of the database files and log files of block 10-102 as indicated in 

35 Figure 4a.. As shown, the database files 10-102 include an action log file 10-1 02a, a control or source 
attributes file 10-1 02b. a message template databases file 10-1 02c and a stored messages (keep) database 
file 10-102d. The source log files include any number of system error log files 10-102e and ASCII log files 
10-102f. Additionally, block 10-102 includes a diagnostic configuration file 10-102g used by rsfd daemon 
10-110. 

40 The action log file 10-1 02a. shown in greater detail in Figure 5c, is used to maintain a record of actions 
for one of the system error log files 10-102e designated as "system." As indicated in Figure 5e, each action 
includes the data and time theaction was initiated, the path of the action program, the result of the action 
(successful, unsuccessful) and a description of the particular action performed (e.g. callout). 

The control or source attributes file 10-102b is shown in greater detail in Figure 5a. As shown, it 
45 contains one record for each source (log file) being monitored by RSF unit 10-8. Each such control record 
includes an identifier field specifying tfie user's name for the source, the path for accessing the source, the 
action to be taken such as identifying the program to be executed upon detection of an overthreshold 
condition, the type of source, and cleantime and searchtime values. 

The message template databases file 10-1 02c is shown in greater detail in Figure 5b. As shown, it 
50 contains informatin about all potential messages that are being monitored for a particular source. This 
includes search criteria (message IDs for system error log files or regular expressions for ASCII log files) 
and information used to determine if the message is overthreshold. 

The stored messages (keep) database file 10-102d is shown in greater detail in Figure 5d. As shown, 
the file contains messages of variable length, each of which include the following fields: ID. time stamp, 
65 expiration data, length of message and message field which store the indicated information. This database 
is used to carry out tfireshold detection operations. Since its operation is not pertinent to an understanding 
of the present invention, it is not described in further detail herein. 
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Examples of system error log files 10-I02e and ASCII log files l0-102f are shown in Figure 5e. The 
system error file of Figure 5e is shown in human readable form as generated by system 10-4 of Figure 1. 
Each entry includes the following fields: ID, label, type, class and error description. The ID field is an 8- 
characler hexadecimal number which uniquely identifies each of the potential messages in the host system 
5 error log. The label field identifies the particular error condition. The type field indicates the type of error 
such as unknown, temporary (transient) and permanent (hard). 

The class field indicates whether the error is a hardware (H) or software (S) error. The error description 
field provides a description of the error condition. 

The ASCII log file includes lines of text separated by new line characters as shown in Figure 5e. The 
10 text lines can take any form. In the case of clock errors, it was convenient to indicate the date, time, source 
and clock adjustments- 
Considering the command programs of block 10-106 in greater detail, the make message template 
(mkmsgtmp) command program 10-1 06a allows for creation of an initialization file 10-1061 which contains 
groups of messages to be added to the message template database file 10-1 02c for a particular source by 
75 programs 10-1 06b, 10-1 06c and 10-106e defining the potential messages to be monitored for over threshold 
conditions. 

In greater detail, the mkmsgtmp program 10-1 06a reads in the standard input from a host system utility 
program normally used to print out all of the message templates utilized by the operating system 10-4 
which contains information for all possible error messages which can be utilized by the host system 10-2. 
20 The user can set up values in tables within the configuration file which specify particular parameters, such 
as threshold, duration, keepmax values, for certain classes or types of potential error messages. The 
following is an example of such a configuration file: 



30 



35 



40 



HARDWARE 




PEND 


2 


10-mins 


10 


PERF 


5 


1-hour 


10 


PERM 


1 


1-day 


10 


TEMP 


20 


1-day 


21 


UNKN 


1 


1-hour 


10 


SOFTWARE 








PEND 


7 


1-day 


10 


PERF 


10 


1-day 


11 


PERM 


6 


1-hour 


10 


TEMP 


25 


1-day 


26 


UNKN 


6 


1-hour 


10 


RE 








X.*25 


-5 


1-hour 


+ 20 



When mkmsgtmp program 10-1 06a is invoked, it reads entries from system 10-4, examines the 
configuration file tables to determine which parameters the user has specified for that particular potential 
message and writes a record in the initialization file containing that potential message with the specified 
parameters. The mkmsgtmp program 10-1 06a is used for the creation of system source initialization files 
only. Examples of such initialisation files are as follows: 



50 



ASCII SOURCE INITIALIZATION FILE: 


#expression 


threshold 


duration 


keepmax 


"system ^error 

"i/o error on-device.'" 


2 
5 


1-day 
4-days 


50 
20 
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SYSTEM SOURCE INITIALIZATION FILE: 


#id 


threshold 


duration 


keepmax 


23e44f01 


2 


1-day 


50 


abcdef 1 1 


3 


2-hours 


50. 



As explained herein, the command programs 10-1 06b. 10-1 06c and 10-106e can be invoked in a way to 
use the contents of the initialization file 10-1061 to add a group of records at a time containing potential 

10 messages to a message template database Included within block 10-1 02c. An example of the type of 
information written Into the message template database is shown in Figure 5b. 

The mkmsrc command program 10-1 06b in response to an mkmsrc command which is generated by 
either unit 10-8 or from console 10-14 initiates the operation of defining a new source to be monitored by 
unit 10-2 (i.e., either a system log file or arbitrary ASCII log file). The mkmsrc command described in 

75 greater detail in the appendix provides the necessary parameters in a generated command line. The 
mkmsrc program 10-1(^b parses the command line and performs the necessary error checking operations 
for validating the command line p^arameters to ensure that source is valid. It then accesses the control 
routines of library 10-104 for writing a control record with the appropriate source attribute information into 
the control file database 10-1 02b. 

20 If the command line includes an initialization file parameter option, this causes mkmsrc program 10- 

106b to access the search routines of library 10-104 to write the records previously stored in initialization 
file 10-1061 containing all of the potential messages to be monitored for a particular source into the 
message template database file of block 10-1 02c. The result is a database such as shown in Figure 5b, 
Continuing with the other commands that can utilize initialization file 10-1061. the chmsrc program 10- 

25 106c allows modification of the message attributes of a particular source (e.g. 10-102e or 10-l02f) being 
monitored utilizing the control routines of library 10-104. This program is invoked in response to a chmsrc 
command with the appropriate command line such as described in the appendix. If the command line 
includes an initialization file option parameter, then chmsrc program 10-I06c accesses the search routines 
of library 10-104. The program 10-1 06c causes the record contents of the source's message template 

30 database to be replaced with the messages previously stored in initialization file 10-1061. It will be 
appreciated that with few exceptions, the information contained in initialization file 10-1061 and information 
contained in the source's message template database is the same information, except for the following 
differences. The initialization file is in human readable format, while the message template database is in 
binary format. The message template database also contains count information which is initialized to zero 

35 when the messages are added. 

The last command program which utilizes initialization file 10-1061 is mkmsg program 10-106e. This 
program enables a message to be added to a source's message template database utilizing the search 
routines of library 10-104. This program is invoked in response to a mkmsg command with the appropriate 
command line such as described in the appendix. If the command line includes an initialization file option 

40 parameter, then mkmsg program 10-1 06e via the search routines adds the messages previously stored in 
initialization file 10-1061 to the source's message template database. 

The Ismsrc program 10-1 06b allows information pertaining to one or more identified sources being 
monitored by unit 10-10 to be displayed or printed using the control routines of library 10-104. This 
program is invoked in response to a Ismsrc command which generates an appropriate command line such 

45 as described in the appendix. The program 10-1 06c invokes various routines contained in library 10-104 for 
accessing information contained in action log 10-1 02a and control file 10-1 02b. to be displayed or printed 
as specified by the command line parameters. 

The rmmsrc program 10-I06d allows the removal of a source being monitored. This program is invoked 
in response to a rmmsrc command with an appropriate command line such as described in the appendix, 

50 When invoked, program 10-I06d utilizing the applicable routines of library 10-104 removes the appropriate 
record from control file 10-1 02b. removes the source's message template database, removes the appro- 
priate keep-base information pertaining to the source and action log information for the specified source. 

The Ismsg program 10-I06f allows the listing of messages being monitored for a particular source. This 
program is invoked in response to a Ismsg command with the appropriate command line parameters such 

55 as described in the appendix. The program 10-106f invokes the appropriate routines in library 10-104 for 
accessing information contained in control file 10-1 02b, and the source's message template database used 
in listing such messages. 
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The chmsg program 10-I06g allows modification of the attributes of messages being monitored. This 
program is invoked in response to a chmsg command with the appropriate command line parameters such 
as described in the appendix. The program 10-106g invokes the appropriate routines in library 10-104 
accessing the control file 10-1 02b to obtain the record specific to the identified source and uses the 
5 specified message ID to locate the message to be changed in the message template database. It then 
updates the message template database with all the changes made to the message. It also updates the 
keep database 10-102d as required so as to properly reflect and be consistent with such changes (e.g. if a 
new threshold value is less than the current count, the appropriate keepbase record entry for that message 
is cleared). 

10 The rmmsg program 10-106h is used to remove a record from a message template database thereby 

stopping RSF unit 10-10 from monitoring a particular message for a particular source. This program is 
invoked in response to a rmmsg command with the appropriate command line parameters such as 
described in the appendix. The program 10-106h in turn invokes the appropriate routines in library 10-104 
which remove the message from the message template database of block 10-1 02c identified by the 
/5 command line parameters, in addition to removing alt messages stored in the keep database of block 10- 
102d having the same message identifier. 

The chrsf command program 10-106 is used to start and stop/shut down the operation of rsfd daemon 
10-110 and netactd daemon of cluster service component 10-300. This program is invoked in response to a 
chrsf command with the appropriate command line parameters described in the appendix. When invoked. 
20 the program 10-106 accesses the PID routines in library 10-104 for accessing the RSF PID file to determine 
if the rsfd daemon is running. The program 10-1 06i then initiates the appropriate action to start or stop the 
daemons as specified by the command line parameters. For the purposes of the present invention, the 
daemons are started and stopped in a conventional manner using the facilities of system 10-4. 

The confdiag program 10-106j allows configuration of a diagnostic callout feature which enables callout 
25 action to be initiated at selected intervals such as daily, weekly, biweekly, monthly or bimonthly. This 
program is invoked in response to a confdiag command with the appropriate command line parameters 
described in the appendix. When invoked, the program accesses the appropriate routines in library 10-104 
which enter the frequency at which a diagnostic message is to be injected into the system error log 10- 
102e as designated by the command line parameters into the diagnostic configuration file 10-102g add the 
30 diagnostic message to the system log source's message template database. 

The rsfstat program 10-1 06k allows the status or configuration of the daemons utilized by RSF unit 10- 
10. This program is invoked in response to a rsfstat command with the appropriate command line 
parameters described in the appendix. When invoked, this program accesses the appropriate routines in 
library 10-104 which determine through the PID files which daemons are running and displays such status 
35 on host system 10-2. There is one PID file for each daemon. 

DESCRIPTION OF RSF DAEMON 10-110 

The rsfd daemon 10-110, for the purpose of the present invention, operates in the background like any 
standard daemon running in a UNIX-based operating system. As discussed herein, rsfd daemon 10-110 
performs checks on message sources and when necessary executes preconfigured actions. It also 
maintains the message template search database, keepbase and action log files 10-1 10a, 10-101a. 10-102c 
and 10-102d. Accordingly, daemon 10-110 maintains a list of such managed message sources including 
information such as the control record and open file descriptors for the template search database and 
keepbase- In addition to using certain ones of the library routines, the rsfd daemon also uses a number of 
its own routines. These include event routines, action routines, signal routines, initialization routines, source 
search routines, keepbase and diagnostic message routines. The event routines are used to schedule 
events by creating new event structures which are placed on an event list, described later herein. 

The action routines are used to free and allocate space for action data structures, calculate arguments 
for action process arKi place them in an argument list in the action data structure. 

The signal routines perform waits for the finished child processes and get the PIDs. It looks up the 
action records and adds the records to the action log of the associated source. 

The initialization routines read the control file and initialize the source list. It reads entries from the 
control file and for each entry it opens all associated files, creates a new source item and places it on the 
list. It opens the message template database, the keepbase and source files. It initializes the action list to 
NULL. As discussed herein, the initialization routines schedule initial events. 

The source search routines perform message scanning of a particular source. That is, they read 
messages from the source, compare messages against the message template database, manipulate counts. 
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manage the keepbase and perform actions if necessary. If a match between the source file message 
template database is detected, it adds the message with time stamp Information to the keepbase. If a 
message template (search) database entry for a message is already overthreshold, this is noted and the 
message count is updated. 

5 The keepbase cleaning routines delete excess messages and search for overthreshold errors for a 

source starting at the beginning of the keep database. The diagnostic routine writes a specified message 
into the system error log file. 

SYSTEM ACTION COMPONENT 10-200 

10 

DETAILED DESCRIPTION - FIGURE 4b 

Figure 4b shows in greater detail, a portion of the system action component 10-200. tAore specifically, it 
shows the modules which make upr the callout manager module 10-210. These modules correspond to a 

15 make call (mkcall) module 10-210a. a calld daemon 10-210b, a file 10-210c containing a set of call control 
file access routines, a list call (Iscall) module 10-210d. a change call (chcall) module 10-210e. a remove 
(rmcall) module 10-21 Of and a call control (callctrl) file 10-210g which are operatively coupled as shown. 
The Iscall module 10-210d allows callout requests stored in a callout queue in file 10-210g by the callout 
manager 10-210 to be listed. As discussed, callout manager 10-210 controls the timing and sequencing of 

20 callout requests made to a response center. It manages the callout requests stored in the callout queue. 
The callout queue is serviced by calld daemon 10-210b and parameters relating to the queue can be set by 
chcall module 10-210e. This queue also can be manipulated by mkcall module 10-210a and rmcall module 
10-21 Of. 

The Iscall module 10-210d is invoked by a Iscall command with the appropriate command line 
25 parameters described in the appendix. When invoked, module 10-210d accesses the call control file access 
routines of block 10-210c to read out queued callout requests for listing as specified by the command line 
parameters. 

The chcall module 10-210e is invoked by a chcall command with the appropriate command line 
parameters descrit^ed in the appendix. When invoked module 10-210e enables configuration of the delay 
30 and max calls parameters stored in file 10-210g and used internally by the callout manager 10-210 in 
controlling the processing of queued callout requests. 

The rmcall module 10-210f is invoked by a rmcall command with the appropriate command line 
parameters described in the appendix. When invoked, module 10-21 Of utilizing the call control file access 
routines of block 10-210c removes callout requests from the callout queue as specified by the command 
35 line parameters. 

The calld daemon 10-21 Ob. as Indicated, services the queue by scanning it for waiting callout requests 
and executing the requested callout action by transmitting a callout record created by callact module 10- 
218 via callouVcallbin module 10-220 and modem 12 to the response center. 

The mkcall module 10-210a in response to receipt of a call action request from callact module 10-218 

40 sets up a new record entry after determining that there are not too many callout requests waiting. It uses 
the command line parameters received from module 10-218 to be added to the callout queue of call control 
file l0-2l0g. It then updates its callout count and next sequence number in a call control header used to 
identify the sequence of callout requests. 

The other modules of Figure 4b will now be discussed in greater detail. The call configuration (callcfg) 

45 module 10-214 allows the display and modification of all of the various parameters in configuration file 10- 
216. The module 10-214 is invoked in response to the callcfg command with the appropriate command line 
parameters as described in the appendix. When invoked, module 10-214 accesses the callconf file 10-216, 
reads it. verifies that the specified subpackages are installed and modifies the applicable configuration 
structure according to the command line parameters. Also, module 10-216 displays the different conflgura- 

50 tion parameters as specified by the command line parameters. 

The callforce module 10-212 performs a forced callout operation with a user defined free form record of 
data. This module 10-212 Is invoked in response to a callforce command with the appropriate command line 
parameters described in the appendix. When invoked, module 10-212 determines which editing facility in 
system 10-4 to use to create the free form record, gets the user generated callout message from a user file 

55 and generates a callout record containing the required information. The module 10-212 then performs the 
callout operation via callout module 10-220 in the case of a standalone host system or via the rietact 
module 10-320 in a cluster system. 
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CLUSTER SERVICES COMPONENT 10-300 - FIGURE 4c 

Figure 4c shows in greater detail, the cluster services component 10-300 can be viewed as having a 
cluster client subcomponent 10-300a and cluster server subcomponent 10-300b. Callcfg module 10-314, 

5 callconf file 10-316. callacl module 10-318. calUorce module 10-312 and netact module 10-320 make up the 
cluster client subcomponent 10-300a. The netact daemon 10-320 and netcall module 10-320 make up the 
cluster server subcomponent l0-300b. The callact module 10-318 and callforce module 10-312 perform the 
same functions as described in connection with system action component 10-200. The netact module 10- 
320 when invoked by either module 10-312 or 10-318 in response to receipt of command arguments, 

70 contacts the cluster server system subcomponent 10-300b via the operating system network facilities and 
sends the command arguments to netactd daemon 10-320. The daemon 10-320 in turn calls netcall module 
10-320 which sends out a callout record to the response center 16 via callout module 10-220 in the case of 
callforce module 10-312 or through the callout manager in the case of callact module 10-312. 

75 CALLBACK COMPONENT 10-400 FIGURE 4d 

Figure 4d shows in greater detail, the mirroring subcomponent 10-402 and permission control subcom- 
ponent 10-422 of callback component 10-400. As shown, subcomponent 10-402 includes a remote account 
module 10-403. a command for configuring monitoring options (confmon) module 10-404, a monitoring 

20 configuration file 10-405. a callscript module 10-406. a PID file 10-407, an interactive session monitoring file 
10-408, a session log file(s) 10-409. a Isles module 10-410. a rmlses module 10-411, a showlses module 
10-412, a showses module 10-413 and a showscript module 10-414. These modules and files are 
operatively coupled as shown in Figure 4d. The .profile module 10-403 is operatively coupled to receive the 
remote login from the TAG 14 via modem 12. The login is received and processed by host system 10-2 in 

25 a conventional manner through the remote login facilities of UNIX based system 10-4. However, the .profile 
module 10-403 causes the remote login session to be executed in a predetermined manner under control of 
callback component 10-400 as described herein. 

The confmon module 10-404 allows the configuration of the callback monitoring sessions by mirroring 
subcomponent 10-402. The confmon module 10-404 is invoked in response to a confmon command with 

30 the command line parameters described in the appendix. When invoked, module 10-404 reads the existing 
configuration from configuration file 10-405, processes the command line parameters, performs any 
necessary checks and writes the new configuration into configuration file 10-405. 

The callscript module 10-406 performs the required operations necessary to carry out the scripting 
operations in response to a callscript command with the command line parameters described in the 

35 appendix. When invoked, module 10-406 opens up the appropriate file(s) into which data from modem 12 is 
to be written, then sets the terminal modes and routes the data into the designated files (i.e.. 10-408. 10- 
409). Additionally, the module 10-406 also accesses PID file 10-407 as required for recording the process 
ID of the child process it creates to carry out the operation specified by the command line parameters. The 
child process alos poerforms other functions such as closing those files opened by the parent process not 

40 needed by the child process. 

The showscript module 10-414 operatively couples to administrator console 10-14. The module 10-414 
allows display or playback of the monitoring output captured by callscript module 10-404 and stored in one 
or more of the files 10-408 and 10-409 during a scripting session. The module 10-414 is invoked in 
response to a showscript command with the command line parameters described in the appendix. The 

45 command may be initiated by GMIS unit 10-8 through showlses module 10-412 and showses module 10- 

413 as indicated in Figure 4d. When invoked, module 10-414 reads the files-created by callscript module 
10-406 and enables playback of the session files on console 10-14 in two nnodes. In one mode, module 10- 

414 shows complete session and terminates operation. In another mode, it shows the current session as it 
is being created and where the end of the file is reached it wajts for more data to be added to the file. 

50 The first mode is carried out under control of showlses module 10-412 while the second mode is 
controlled by showses module 10-413. The showlses module 10-412. as mentioned, allows the playback of 
a completed or logged session. The module 10-412 is invoked in response to a showlses command with 
the command line parameters described in the appendix. When invoked, module 10-412 performs the 
necessary checks (i.e.. access permission and valid command line argument). It obtains the designated or 

55 named logged session(s) to be reviewed and provides the required parameters to showscript module 10- 
414 for displaying the session file(s). 

The showses module 10-413, as mentioned, allows the playing of a currently active session, if available. 
The module 40-413 is invoked In response to a showses command described in the appendix. When 
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invoked, showses module 10-413 p^erforms the necessary checks and verifies that there is a current session 
taking place (i.e.. callscript nnodule 10-406 is running). If there is current session running, nnodule 10-413 
passes the required parameters for displaying the current session to showscript module 10-414. 

The Islses module 10-410 allows listing of logged sessions. This module is invoked in response to a 
5 Islses command described in the appendix. When invoked, module 10-410 accesses the directory of 
session log files 10-409 and lists the logged sessions using the facilities of system 10-4. 

The rmlses module 10-411 allows removal of logged sessions. This module is invoked in response to a 
rmlses command which generates command line parameters described in the appendix. When invoked, 
module 10-411 performs permission and command argument checks and then accesses the directory of the 
10 session log files 10-409 and removes the specified session. 

The permission control subcomponent 10-422 includes a doremote module 10-424, a remote configura- 
tion (remote conf) file 10-426, a configure permissions (confperm) module 10-428, a privileged tasks 
function module 10-430 and nonprivileged tasks function module 10-432. The modules are operatively 
connect as indicated in Figure 4d. 
75 The doremote module 10-424 performs operations for the "remote" user that require a certain level of 

permission. The module 10-424 is invoked in response to a doremote command which generates command 
line parameters described in the appendix. When invoked, module 10-424 accesses remote config file 10- 
426 for determining if root access is allowed. When it is, the module spawns a root subshell. 

The confperm module 10-428 allows the configuration of permissions to be granted to remote users 
20 who have logged onto the host system 10-2 through remote account module 10-403 and operating under 
the control of callback component 10-400. This module is invoked in response to a confperm command with 
the command line parameters described in the appendix. When invoked, module 10-403. It accesses the 
permissions configuration file through access routine, not shown, similar to those described above and 
reads the existing configuration from file 10-426. It then processes the command line parameters and writes 
25 the new configuration into file 10-426. 

The privileged tasks module 10-430 and the nonprivileged tasks module 10-432 provide the appropriate 
interface call parameters to the operating system 10-4 required for carrying out their respective tasks. 

RSF UNIT MENU SYSTEM - FIGURE 6 

30 

As discussed above, the RSF unit 10-10 utilizes the generic menu interface system (GMIS) unit 10-8 
which provides a graphic interactive screen oriented command interface. This interface in the preferred 
embodiment uses a hierarchical screen organization which includes menu, selector and dialog screen to 
generate the required command line parameters for causing RSF unit 10-10 to perform a specific task. 

35 Figure 6 Illustrates the relationships between the different menu, selector and dialog screens utilized by unit 
10-10 according to the present invention. As indicated, RSF unit 10-10 is accessible from the top level of 
the menu system which corresponds to a problem determination submenu. This submenu includes four 
selection items corresponding to message sources, messages, actions and callout/callback. All four menu 
items lead to submenus and all traversals down through the menu structure eventually lead to dialogs for 

40 each RSF command associated with the menu selection. Therefore, the different command line operations 
described above in connection with Figures 4a through 4d are normally carried out using this Interface. 

DESCRIPTION OF RSF CONFIGURATION PROCESS 

45 FIGURES 7a THROUGH 71 

Figure 7a illustrates a sequence of configuration operations which have been chosen only for the 
purpose of explaining by way of example, how the different components of RSF unit 10-10 can be 
configured to operate according to the present invention. In many instances, the parameters being 
50 configured in the example would normally have been preconfigured within unit 10-10 and the user or 
customer running the host system 10-2 would only need to modify such parameters if there was a need to 
do so. 

Considering Figure 7a. It is seen that to integrate RSF unit 10-10 into host system 10-2, an install 
operation is performed as indicated by block A. This operation Is initiated by a user through GMIS unit 10-8. 
55 The install operation proceeds in a conventional way relative to placing the diskettes containing the RSF 
subpackages into an available disk drive device. The user next selects the device name for the drive device 
to be used for installing RSF (e.g. /dev/fdO) by an initial dialog menu. The user upon indicating to unit 10-8 
to continue the install operation, is next presented with the dialog menu of Figure 8a- 
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As shown, the menu indicates that the previously nanned device is the device being used to install the 
RSF subpackages. The user changes the "SOFTWARE to install" menu item to select only the subpac- 
kages that are required for the type of host system configuration which is going to use RSF unit 10-10. 
Assuming that the host system is configured as a standalone system, the user would make the selections 

5 as shown in Figure 7b. This is carried out by selecting the ''List** button next to the "SOFTWARE to install" 
field. This causes the unit 10-8 to display the selector menu of Figure 8b. Next, the user selects both the 
"obj" and "data" parts for each subpackage which is to be installed. Such selections are made according to 
Figure 7b. After each subpackage selection is made, the user causes the dialog to be executed according 
to the instructions displayed on the menu screen. As indicated in Figure 7b. after completing the selection 

10 process of block 700. the user causes the dialog to be executed which begins the installation operation of 
block 702. During this operation, the host system 10-2 prompts the user for the disks to be swapped during 
the installation. In the present example, the result is that subpackages 10-100. 10-400 and 10-200 will be 
installed in host system 10-2, 

As indicated in Figure 7a, by way of example, the user performs the operation of configuring a host 

75 system source such as ASCII source 10-102f of Figure 4a. The sequence of operations for configuring the 
source is shown in detail in Figure 7c. Referring to Figure 7c, it is seen from Figure 6 that the user selects 
the "message sources** submenu from which can be run, four tasks, one of which is labeled "add a 
source." The submenu can be selected directly through a fast path. For this submenu, the user types GMIS 
msg sources. This results in the display of the first submenu of Figure Be as indicated by block 710 of 

20 Figure 7c . 

The user by selecting the "add a source" menu item causes the display of the dialog screen shown in 
menu #2 of Figure 8c. 

As indicated by blocks 712. 714 and 716. the user enters information such as the source identifier, 
source path name and the pathname of the action to be executed such as a callout action indicated as 

25 /usr/bin/callact. Next, as indicated by block 718, the user enters information specifying the source type as 
an ASCII source which is indicated as "ASCII." Also, the user specifies the source's cleanttme and 
searchtime parameters as indicated by blocks 720 and 722. 

In adding the source, the user also needs to specify the potential messages which are to be monitored 
by the source being added. This can be done in two ways. One way is to prepare an initialization file ahead 

30 of time either manually or by using the mkmsgtmp program 10-106a in the manner previously discussed. In 
that case, the user need only specify the initialization file as indicated by block 724 and then perform the 
indicated dialog. The block 106 of Rgure 4a will cause these messages to be added to the message 
template database for the specified ASCII source 10-102f when the source is added. The GMIS unit 10-8 
generates a command line for the mkmsrc command with the user supplied information. Mkmsrc program 

35 10-1 06b causes the source to be added by establishing the appropriate control record for the ASCII source 
within control file 10-1 02b in the manner discussed above. 

If an initialization file has not been prepared ahead of time, the user can add messages one at a time 
by selecting the "add messages to message template database" submenu. As shown in Figure 6, this 
submenu is displayed by selecting the "add messages to message template database" item of the 

40 messages submenu as indicated in block 730. Selecting this item results in the display of a selector screen 
containing the identifiers of all sources currently being monitored by RSF unit 10-10. The user selects the 
source identifier that was just added as indicated in block 732. Once the desired source is selected, the 
dialog screen of Rgure 8d is displayed by GMIS unit 10-8. 

Next, as indicated in block 734, the user selects the regular expression value for the message which is 

45 the parameter used to match messages read from ASCII log file 10-102f. The user next performs the 
operations of blocks 736 through 738 for selecting the message threshold, the duration and keepmax 
parameters for that message. This results in the generation of a mkmsg command line by GMIS unit 10-8 
which invokes the mkmsg program 10-106e of Figure 4a. As previously discussed, this program causes the 
message having the user specified parameters to be added to the message template database of the added 

50 ASCII source as indicated by block 740. If there are more messages to t>e monitored for the source, then 
the user repeats the sequence defined by blocks 730 through 740 for each message to be added. 

Following completion of adding an ASCII source, the user by way of example, next configures a system 
source as indicated by block C in Figure 7a. This operation is performed in the same way as configuring an 
ASH source. The only differences are when the user specities the source type. "SYSTEM" is selected 

55 instead of ASCII. Also, instead of selecting a regular expression value, the user selects a message identifier 
(ID) which uniquely identifies each of the potential messages in the host system error log 10-102e of Figure 
4a (see Figure 5e). The above described arrangement facilitates the addition of other types of binary log 
files having specific structures. 
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As seen from Figure 7a. the user by way of example, next performs the configure callout operation of 
block E for configuring the system action component 10-200 of Figure 4b. The sequence of operations 
performed relative to block E are shown in Figures 7d and 7e. 

As indicated by block 750 of Figure 7d. II is necessary to determine if the host system utilizing RSF 
5 unit 10-10 is a cluster client system since the operations for configuring the callout component are different 
for the cluster client system than those for configuring a cluster server or standalone system. The reason is 
that the cluster server or standalone system includes a directly connected modem. Since the cluster client 
system performs the callout function through a cluster server system over the LANAA^AN, the user of a 
cluster client system does not have to configure all of the parameters which relate to such modem 
10 connection. 

Since the host system 10-2 is a standalone system, the user performs a "configure callout (local 
modem)* selection of block 752 which results in the display of the submenu of Figure 8e by GMIS interface 
10-8 as indicated in block 753. The menu path is as indicated in Figure 6. 

The submenu of Figure 8e contains a set of selections that allows customization of the autodial function 

75 of component 10-200. These selections include site parameters, modem parameters and callout tuning. 
Selecting the "site parameters" item of block 754 results in the display of another submenu such as shown 
in Figure 8f. As indicated in block 756, this submenu contains further selections for manipulating local 
operator and system information. 

When the user selects the "System Identifier" menu item of Figure 8f. this causes GMIS unit 10-8 to 

20 generate submenus requiring further user actions. The set system identifier operation of block 758 is shown 
in greater detail in Rgure 7e. Upon selection of the "set system identifier" item on the displayed submenu, 
GMIS presents a dialog screen which asks the user to select what type of support center protocol will be 
used as indicated by block 758. This allows the host system 10-2 to communicate with response centers in 
different geographical areas which may use different standard protocol sequences/procedures for process- 

25 ing support calls. As indicated by block 758-2. the user selects either "RC" or "SC." This results in the user 
performing the operations of either block 758-4 or block 758-8. For block 758-5, the user only enters the 
system number information. In the case of block 758-8. the user enters several items of information which 
are the site identifier, the model, the serial number and a TAG character ail of which have some specific 
meaning to the SC site processing the host system call. In either case, upon completing the entering the 

30 required information Items, the user executes the dialog according to the instructions on the menu to 
execute the procedure for storing the system identifier parameters (i.e., "execute dialog in blocks 758-4 and 
758-8"). This causes GMIS unit 10-8 to generate a callcfg command. The callcfg command is provided with 
a command line containing alt of the required system identifier parameters defined by the user which are 
provided or passed in the proper form to callconfig module 10-214 for causing the storage of the user 

35 selected system identifier parameters in callconfigfile 10-216, Independent of which procedures are 
executed, both lead to the operation of block 760 of Figure 7d. 

When the user selects the "BBC Phone Numbers" menu item according to block 760, this results in the 
display of the submenu of Figure 8g. This submenu allows the user to list, add or delete response center 
telephone numbers sequentially as indicated in block 762. When the user selects the item "Add a BRC 

40 Phone Number," this allows the user to enter or configure each of the proper phone numbers as indicated 
by blocks 764 and 766. The GMIS unit 10-8 generates a callcfg command to carry out the required 
"execute dialog" of block 766. 

As described above, callcfg command is provided with a command line containing the appropriate 
phone number parameters based upon user selections which are provided to the callconfig module 10-214 

45 for causing storage of the user selected parameters in callconfig file 10-216. 

As indicated by block 768 in Rgure 7d. the user repeats the operations of blocks 764 and 766 until all 
of the proper phone numbers have been entered. Next, the user returns to the "site parameters" submenu 
as indicated by block 770. This involves following the path indicated in Figure 6 for again displaying the 
submenu of Figure 8f. This time, the user selects the "other side parameters" menu item which results in 

50 the displaying of the submenu of Figure 8i. 

As indicated by block 774. the user enters other site parameters such as those illustrated in Figure 8i. 
As shown, these include operator name and phone number, system phone number, remote password, the 
path name of the terminal (TTY) utilized in making the callout operation and the E-Mail address of the local 
system operator or to the person whom notification of the callout attempt should be sent. The operator 

55 name and phone number enables the TAG 1 4 to contact the k)cal system operator to arrange for a problem 
determination session. The remote password enables access to the remote account module 10-403 of 
callback component 10-403 of Figure 4d. When the local administrator or user does not wish to allow 
remote access, this item is left blank. It will be appreciated that the actual password is set by using the 
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"passwd" command facilities of system 10-4. The user then executes the dialog according to the 
instructions displayed by the submenu of Figure 8i to execute the procedure for processing the entered 
information. As described above, it causes GMIS unit 10-8 to generate a callcfg command. The callcfg 
command is provided with a command line containing all of the required user entered other site parameters 

5 which are passed in the proper forms to callconfig module 10-214 for causing the storage of such 
parameters in callconfig file 10-216. 

As indicated by block 776. the user backs out to the "configure callout (local modem)" menu of Figure 
8e. This is done by sequencing back through the path indicated in menu system of Figure 6. As indicated 
by block 780. the user determines if the modem being used by host system 10-2 is the normal 

10 preconfigured (default) modem connection. If it is not. the user selects the "modem parameters" menu item 
of Figure 8e <r.e„ block 782). This causes GMIS unit 10-8 to display the submenu of Figure 8j as indicated 
by block 782. 

The user p>erforms the sequence of operations of blocks 786 through 810 for certifying that the correct 
modem communication string parameters are provided for configuring callout communications for both 

75 standone alone and cluster server system configurations. 

As shown, the user selects the "OK strings" menu item on the display submenu of Figure 8j. This 
causes GMIS unit 10-8 to display the submenu of Figure 8k as indicated by block 788. As seen from Figure 
8k. the user can list, add or delete OK strings. OK strings are the messages sent by the modem indicated 
the successful completion of a modem command. A list of modem OK strings can be displayed by having 

20 the user selecting the "list" menu item of the submenu of Figure 8k as indicated in block 790 of Figure 7d. 

In response to block 790. GMIS unit 10-8 displays the current list of modem OK strings without any 
user dialog. As indicated by block 792. if the user determines that an OK string needs to be added, the user 
then selects the "ADD OK string" item from the menu of Figure 8k. This causes GMIS unit 10-8 to display 
the dialog screen of Figure 81. 

25 Next, the user enters the OK string which for most modems corresponds to the default of "0" and "OK" 
and presses the enter key. This causes GMIS unit 10-8 to execute the required procedure (i.e.. execute 
dialog) as indicated in block 795. That is, this causes GMIS unit 10-8 to generate another callcfg command. 
The callcfg command is provided with a command line containing the user entered OK string and command 
parameters which are passed in the proper format to callconfig module 10-214 for the storage of such 

30 parameters in call config file 10-216. 

If an OK string does not need to be entered, the user determines if an OK string needs to be deleted as 
indicated by block 796. If a string is to be deleted, the user selects the "delete OK string" item on menu 
Figure 81 as indicated in block 797. This causes GMIS unit 10-8 to display a dialog screen similar to that of 
Figure 81. This OK string to delete may be entered manually or selected from a list. In this sequence, when 

35 a string is selected by the user and the dialog is executed to carry out the procedure (execute dialog) 
indicated in block 798. GMIS unit 10-8 causes the removal of the selected string from the list That is. this 
causes unit 10-8 to generate a callcfg command containing a command line which includes the selected 
string and command parameters. These parameters are passed in the proper format to call config module 
10-214 which accesses config file 10-216 and deletes the specified string from such file. 

40 As indicated in Figure 7d. the user can carry out a similar sequence of operations relative to connect 
strings. Connect strings are the messages sent by a modem to indicate that a successful communication 
connection has been established. The operations of blocks 801 through 809 are carried out in the same 
manner as the list, add and delete operations for the OK strings described above. As shown in block 799. 
the user backs out to the "modem parameters" menu screen shown in Figure 8j. This is done by following 

45 the path indicated in Figure 6. 

As indicated in Figure 7d. the user, by selecting the "connect strings" menu item of Figure 8j, causes 
GMIS unit 10-8 to display the submenu screen of Figure 8m. If a connect string needs to be added, the 
user selects the "ADD Connect String" submenu item as indicated in blocks 804 and 805. This causes 
GMIS unit 10-8 to display the dialog menu screen of Figure 8n. Again, the user enters the connect string to 

50 be added and executes the dialog. As indicated in block 806, this causes GMIS unit 10-8 to execute the 
procedure for adding the user entered connect string. That is, GMIS unit 10-8 generates a callcfg command 
containing a command line which includes user entered "connect string" and command parameters. These 
parameters are passed in the proper format to call config module 10-214 which accesses config file 10-216 
and stores the specified connect string. If a connect string needs to be deleted, the user selects the "Delete 

55 Connect String" menu item from the submenu screen of Rgure Bm. enters the string to be deleted and 
executes the dialog as indicated in blocks 807 through 809. This sequence causes GMIS unit 10-8 to 
execute the procedure for deleting the user selected connect string. That is. GMIS unit 10-8 generates a 
callcfg command containing a command line which includes the user selected connect string and command 
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parameters. These parameters are passed in the proper form to call config module 10-214 which accesses 
config file 10-216 and deletes the specified connect string from the file. 

After completing this sequence, the user is able to enter additional modem parameters by backing out 
to the modem parameters submenu screen of Figure 8j. As indicated by blocks 810, 812 and 814. the user 
5 upon selecting the "other modem parameters" menu item on the menu screen of Figure 8j causes GMIS 
unit 10-8 to display the menu screen of Figure 8o. As indicated in Figure 7d, the user can enter several 
other modem parameters. 

As illustrated in Figure 8o, these include selection of modem network protocol (yes or no), a callback 
condition string which defines the modem callin conditioning string, a callout condition string which defines 

10 the modem callout conditioning string, a dial string which is the modem command string that is used to 
execute modem dialing operation, a redo string which is a modem command string used to execute a 
modem dial repeat operation, a disconnect string which is a modem command string used to execute a 
modem disconnect operation, a hang-up string which is a modem command string used to execute a 
modem hang-up operation, a busy string which is a modem reply string for indicating when the dialed 

76 number is busy, character size (bits) parameter defining the number of bits in a character (5-8), a stop bit 
parameter indicating the number of stop bits in a character, a parity parameter for indicating odd. even or 
no parity and a baud rate parameter defining the baud rate of the modem. Upon completing the entering of 
the parameters, the user executes the dialog which causes GMIS unit 10-8 to execute the required 
procedure for adding the user entered modem parameters. That is, GMIS unit 10-8 generates a callcfg 

20 command containing a command line which includes the other modem and command parameters. These 
parameters are passed in the proper form to call config module 10-214 which accesses config file 10-216 
and stores the other modem parameters in the file. 

The final menu item appearing in the "Configure Callout (Local f^odem)" menu screen if Figure 8e is 
"Callout Tuning." The selection of this menu item causes GMIS unit 10-8 to display the callout timing 

25 parameters menu dialog screen of Figure 8u. Although not shown in Figure 7d, this sequence would be 
represented similar to block 776 and 782. A user via the screen of Figure 8u can fine tune several callout 
parameters to satisfy the host system modem performance requirements. More specifically, the user can 
fine tune the following parameters: a try condition parameter specifying the number of retries when 
conditioning the modem, a retry for each number parameter specifying the number of retries to be 

30 attempted for each TAC phone number, a delay between busy retries parameter specifying the delay 
between attempts for retrying a TAC phone number, a modem intercommand delay parameter specifying 
the delay between items of data sent to TAC 12. and a remote time-out parameter specifying the time-out 
period for waiting for data from TAC 12. Upon completing the entering of the parameters, the user executes 
the dialog which causes GMIS unit 10-8 to execute the procedure for adding the callout tuning parameters 

35 to config file 10-216 similar to the manner described above. 

As indicated in Figure 7d, the user next performs the "perform callout management sequence" of block 
830. As indicated in Figure 7d. this sequence would be performed in the case where the host system 
modem is the same as the preconfigured modem as indicated by block 780. Again, the user would backup 
to the configure callout (local modem) menu by following the path Indicated in Figure 6. The user, by 

40 selecting the "callout management" menu item on the menu screen of Figure 8e, causes GMIS unit 10-8 to 
present the menu screen of Figure 8p. As seen from Figure 8p. the user is able to configure different 
callout manager operating parameters as required for controlling the manner in which the callout manager 
processes incoming callout requests received from the host system and any cluster clients. This is done by 
blocks 832 through 839. 

45 As indicated when the user selects the "change/show callout manager status" item on the menu screen 
of Figure 8p. this causes GMIS unit 10-8 to display the dialog screen of Figure 8q. The user can enter the 
amount of time that the callout manager module 10-204 of Figure 3 will delay between consecutive callout 
requests. Additionally, the user can configure the maximum number of callout message requests that callout 
manager module 10-204 will queue at one time. After entering the values in the fields of Figure 8q, the user 

50 executes the dialog to cause GMIS unit 10-8 execute the procedure for storing the configured values. This 
causes GMIS unit 10-8 to generate a chcall command containing a command line including the selected 
callout manager values and command parameters. These parameters are passed to the chcall module 10- 
210e of Figure 4b which using the call control file access routines of block 10-21 Oc, stores the user 
selected callout manager parameters in catlctrl file 10-2l0g. 

55 Also, the user may also want to establish when calld daemon 10-21 Ob of Figure 4b is to t>e started. As 
indicated by block 837, this is done by selecting the "start callout manager daemon" menu item on the 
menu screen of Figure 8p. This causes GMIS unit 10-8 to generate the dialog menu screen of Figure 8r. As 
shown, the user can choose to start daemon 10-21 Ob rww, at reboot time or now and at reboot time. Upon 
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completing the selections, the user executes the dialog to cause GMIS unit 10-8 to carry out the procedure 
of storing the daennon configuration values. This causes GMIS unit 10-8 to generate a chcall command 
containing a command line which includes the user configuration and command parameters. These 
parameters are passed to the chcall module 10-21 Oe which starts the calld daemon and/or uses conven- 

5 tronal system commands to configure boot time behavior. As shown in Figure 7d, this ends the illustrated 
"callout management" sequence- 
It will be appreciated that the user could make other changes or view the status of the callout manager 
module 10-204 by selecting other parameter items on the menu screen of Figure Bp. For example, the "List 
Queued Caliouts" shows all of the callout requests stored in the callout manager queue. The "Show a 

70 Queued Callout" item allows an item from the queue to be shown including the callout contents when a 
queue index value is supplied. The "Remove Queue Callout" item allows a callout request to be removed 
from the queue. The "Show Callout Manager Status" item allows the current callout manager configuration 
and status to be displayed. The "Start Next Callout" item causes the next callout request to start. The 
"Restart Failed Caliouts" causes the status of all failed callout requests to be changed to "Waiting." The 

75 "Display and Reset Callout Records" items allow the callout manager's callout log included within file 10- 
21 Og to be viewed and erased. 

As indicated in Figure 7d, if at block 750 the user determined that the host system was configured to 
operate a cluster client system then the configure callout (cluster client) sequence of blocks 850 through 
858 would be performed. This involves first selecting the "configure callout (cluster client)" submenu. As 

20 indicated in Figure 6, this involves selecting the "configure callout (cluster client) menu item of the 
callout/callback submenu. This causes GMIS unit 10-8 to display the submenu of Figure 8s as indicated in 
block 852. These operations are carried out in the same manner as that described in connection with blocks 
758 and 752. The user selects the "System Identifier" menu item of Figure 8s which causes GMIS unit 10-8 
to display a dialog screen similar to Figure 8f. The user enters the system identifier parameters as a 

25 function of the type of support protocol being provided (i.e.. "RC" or "SC") and executes the dialog causing 
GMIS unit 10-8 to execute the procedure. This causes GMIS unit 10-8 to generate a callcfg command 
including the user selected system identifier and command parameters. These parameters are passed to 
callcfg module 10-214 of Figure 4b which stores them in call config file 10-216. 

In the case of block 856, the user selects the "set other parameters" menu item on the configure 

30 callout (cluster client) menu screen of Figure 8s. This submenu allows the user to configure the host client 
system to make network callout requests to the cluster server system rather than via a directly connected 
modem. This is done by specifying the host name of a cluster server system rather than response center 
phone numbers. In response to such selection. GMIS unit 10-8 displays the dialog menu screen of Figure 
8t. As shown, the user enters local system specific parameters such as operator name, operator phone 

35 number, remote password, cluster server and E-Mail address. After entering the appropriate parameters, the 
user executes the dialog causing GMIS unit 10-8 to execute the procedure for storing the user selected 
parameters in call config file 10-216 of Figure 4b. Again, this is done via a callcfg command. 

Following completion of the configure callout operation of block D. it is assumed by way of example, 
that the user next configures the callback function for establishing how callback component 10-400 of 

40 Figure 4d is to process callback requests made by TAG 1 2. Specifically, this refers to how such processing 
is performed in terms of configuring the level or extent of TAC user access allowed by permissions 
subcomponent 10-422 and configuring how TAC login sessions are to be monitored by mirroring subcom- 
ponent 10-402. 

The configuration operation is shown in detail in Figures 7f and 7g. Referring to Figure 7f, it is seen in 
45 block 900 that the user selects ttie "configure callback" menu item on the callout/callback submenu screen 
which is accessed by the path indicated in Figure 6. The user executes the dialog which causes GMIS unit 
10-8 to display the submenu screen of Figure 9a. As indicated by block 904. the user selects the 
"Configure Permission" menu item which causes GMIS unit 10-8 to display the dialog screen of Figure 9b. 
In accordance with blocks 906 through 912, if the system is a standalone or cluster server system, the user 
50 can choose whether or not remote dial-in access is to be permitted by specifying enabled or disabled. If the 
system is configured as a cluster client system, such access will always be disabled since dial-in is done 
by the cluster server system. Next, the user can then set remote user privileges to allow or deny root 
access to local host system 10-2 in the manner indicated by blocks 914 through 918. This selection is done 
by entering either a YES or NO command. 
55 After entering the appropriate configure permission parameters, the user executes the dialog. This 
causes GMIS unit 10-8 to generate a confperm command with a command line containing the user selected 
permission and command parameters. GMIS unit 10-8 provides these parameters in the proper format to 
the confperm module 10-428 of Rgure 4d which accesses remote configuration file 10-426 for storage of 
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the user configured parameters. 

As indicated in Figure 7f. the user configures the monitoring functionality of subcomponent 10-402. As 
indicated in Figure 7g, this operation is begun by the user selecting the "^configure monitoring" menu item 
of the menu screen of Figure 9a through the path indicated in Figure 6 and executes. This causes Gf^lS 

5 unit 10-6 to the dialog menu screen of Figure 9c. 

In accordance with blocks 920-2 through 920-24, the user enters the appropriate values. The selection 
of the "session notification interactive" menu item enables session notification. This is used to alert the 
system operator in real time that the TAG has connected to the local host system 10-2. Using this type of 
monitoring allows a local administrator to immediately log the remote user off the host system by pressing 

70 the "K" key while running showses module 10-413 of Figure 4d- The selection of the "Notification Device" 
menu item allows the user to specify the device on which session notification will appear when session 
notification is enabled. The selection of the session logging menu entry enables session logging to be 
written into a session database file for later viewing. The selection of the Enable E-Mail on call-in menu item 
enables electronic mail notification to the local system operator that the TAG has connected to the local 

75 host system. The "E-I^ail address" menu item is used to specify where such notification is to be sent. The 
Terminal Type for Gallback" menu item enables the user to specify the terminal type necessary for making 
the TAG callback to the host system. As previously indicated, this parameter requires the TAG to use the 
selected terminal type to ensure that such callback sessions can be viewed on terminal type available within 
host system 10-2. 

20 After all the parameters have been configured, the user executes the dialog to cause GMIS unit 10-8 to 

execute the procedure for storing the user selected monitoring parameters. Specifically, this causes GMIS 
unit 10-8 to generate a confmon command containing a command line which includes the monitoring and 
command parameters. These parameters are provided to confmon module 10-104 which stores the 
parameters in mon config file 10-405. This completes the configure monitoring operation of block E of 

25 Figure 7a. 

Next, the user performs the configure diagnostic operation of block F. This operation sequence allows 
configuring the rsfd daemon 10-110 of Figure 4a to periodically test the end-to-end connectivity between 
the host system and the TAG. This diagnostic configuration will check to make certain that a callout request 
is made by daemon 10-100 when the specified message exceeds threshold by periodically injecting system 

30 error log 10-102e with a diagnostic message. 

This operation is shown in greater detail in Figure 7h. Referring to Figure 7h. it is seen that the 
operation involves execution of blocks 930 through 942. As indicated by block 930. the user selects the 
"actions" menu item on the remote services facilities menu obtained by following the path specified in 
Figure 6. This results In GMIS unit 10-8 displaying the submenu of Figure 10a. The user next selects the 

35 "configure diagnostic" menu item and executes the dialog. In response to such selection, GMIS unit 10-8 
displays the dialog menu screen of Figure 10b. As indicated in Figure 10b. the user enters the appropriate 
parameters according to blocks 936 through 942 and executes the dialog. This causes GMIS unit 10-8 to 
execute the procedure for storing the user selected parameters for accessing by daemon 10-110. That is, 
GMIS unit 10-8 generates a confdiag command which includes the user selected command parameters. 

40 These parameters in the proper form are passed by GMIS unit 10-8 to the confdiag program 10-106 of 
Figure 4a. The program 10-106j utilizing the configuration routines of RSF library 10-104 enables storage of 
the specified parameters within diagnostic configuration file 10-102g. 

Upon completing the operations of Figure 7h. next the user performs the configure daemons operation 
of block G of Figure 7a. The operation involves the execution of blocks 950 through 962 as shown in Figure 

45 7i. Referring to Figure 7i. it is seen that the user again selects the "actions" menu item on the remote 
services facilities menu. This results in GMIS unit 10-8 displaying the submenu of Figure 10a. The user next 
selects the "start RSF daemon" menu item and executes the dialog. This causes GMIS unit 10-8 to display 
the dialog menu screen of Figure lOc. As indicated by block 956, the user is asked to specify if the RSF 
daemon lO-llO is to be started now, at system reboot or both. The user enters the selection and executes 

50 the dialog. This causes GMIS unit 10-8 to execute the procedure for storing the user selected parameters. 
Specifically, it generates a chrsf command line containing the specified command parameters. These 
parameters in the proper form are passed to the chrsf program 10-I06i. Program 10-I06i utilizing the 
appropriate routines of library 10-104 starts the rsfd daemon and/or uses conventional system commands to 
configure boot time behavior. 

55 Next, the user specifies when the cluster server daemon netactd of block 10-320 is to be started. As 

Indicated in block 960, the user selects the "start cluster daemon" menu item of dialog menu screen of 
Rgure 10a and executes the dialog. This causes GMIS unit 10-8 to display the dialog menu screen of 
Figure lOd. The user is asked to specify if the cluster daemon 10-320 is to be started now, at system 
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reboot or both. The user enters the selected choice and executes the dialog. This causes GMIS unit 10-8 to 
generate another chrsf connnnand line containing the specified comnnand which are passed in the correct 
form to chrsf program 10-106i. The program utilizing the appropriate routines of library 10-104 starts the 
netactd daemon 10-320 and/or uses conventional system commands to configure boot time behavior. This 
5 completes the configure daemon's operation of block G of Figure 7a. At this point, the user will have 
completed configuration of each of the RSF components of Figure 3 preconditioning RSF unit 10-10 as 
desired. 

DESCRIPTION OF OPERATION 

10 

Figures 11a through 13d illustrate how certain ones of the RSF components of Rgure 3 operate as 
configured to carry out the remote support function. 

Referring first to Figures 11a through 11c, these figures are used to explain the operation of problem 
detection and reaction component 10-100 of Figure 4a. This component operates under control of daemon 

75 10-110. As discussed, rsfd daemon 10-110 detects problems by scanning the system error log 10-102e and 
ASCII file 10-102f in addition to any other configured source for specific messages and keeping count of 
how many messages of each kind it finds and determining whether or not a message is overthreshold. If a 
message is overthreshold. rsfd daemon 10-110 executes an action. 

As previously described, for each configured source, there is a record stored in control file 10-1 02b 

20 containing assigned attributes, such as how often to scan the source for new messages, how often to clean 
its database and what action to execute if one of the messages in the source goes over threshold. Also, rsfd 
daemon 10-110 maintains the message template database for each source containing the search criteria for 
each message which it uses to scan for particular messages and to count the messages that are being 
searched for on the source. Also, rsfd daemon 10-110 also performs diagnostic callouts. As discussed, it 

25 can be configured to generate a callout action at specific predefined configured time intervals. These 
operations are diagramatically illustrated in the simplified diagram of the problem detection and reaction 
component 10-100 shown in Figure 11a. 

Referring to Figure lib, it is seen that first, rsfd daemon 10-110 performs the setup operation of block 
1100. This operation is shown in greater detail in Figure 11c. As indicated by blocks 1100-2 and 1100-4, 

30 daemon 10-110 opens the source attributes database 10-1 02b and begins reading each of the records from 
the database. Each database record read out is read into an area of main memory 10-3 as indicated in 
block 1100-10 for building an internal list of such records. The daemon 10-110 uses the search time 
parameter in each such record to schedule a search event for the specified source as indicated by block 
1100-12. It uses the clean time parameter in each such record to schedule a clean event for the source as 

35 indicated by block 1 100-14. 

The daemon 10-110 performs the operations of blocks 1100-10 through 1100-14 for all of the sources 
having records in the source attributes datat)ase 10-102b. Upon completion of this operation, which is 
signalled by an end of file indication, daemon 10-110 next reads the diagnostic configuration parameters 
from diagnostic configuration file 10-102g as indicated by block 1100-6. As indicated by blocks 1100-8 and 

40 1100-9, when the parameters indicate that the diagnostic feature has been enabled, daemon 10-110 uses 
the diagnostic frequency parameter to schedule a diagnostic event. This completes the setup operation of 
block 1100. At this time, the daemon 10-110 will have scheduled all of the different events in an event 
queue which will control its operation from that time. 

Following setup, daemon 10-110 will enter a loop wherein it will wait for the occurrence of the next 

45 event as indicated by clock 1102. When the event occurs, daemon 10-110 gets the event from the event 
queue and schedules the next occurrence of that event as indicated by blocks 1104 and 1106. Next, 
daemon 10-110 performs a dispatch operation of block 1108 based on the type of event to one of the 
routines of blocks 1108, 1110 and 1112 (i.e., search type, clean type and diagnostic type). When it is done 
processing the event, daemon 10-110 returns to block 1 102 to wait for the occurrence of the next scheduled 

50 event. 

Figure lid shows in greater detail, the search operation of block 1108. As seen from Figure lid. in 
processing the search event, daemon 10-110 reads messages from the log file for that source as indicated 
by block 1 108-2. It will continue to process any new messages that are in that log file as indicated by block 
1108-4. In order to read each message from the log file, it performs a dispatcfi operation based upon the 
55 log type as indicated by block 1108-12 (i.e.. constructs a dispatch call based on log type). The daemon 10- 
110 uses the source type parameter to determine which routine to call to read the nnessage. In the present 
host system, there are two types of search routines, one for reading ASCII log file 10-102f and another for 
reading system log file 10-102e. As indicated by block 1108-12. once a message has been read, daemon 
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10-110 again uses the source type parameter to determine which routine to call to search for a match 
through the message templates for that source. In the case of ASCII log file 10-I02f, daemon 10-110 calls 
the regular expression matching search routine which looks for regular expressions in records in the 
source's message template database which match the record just read from the ASCII log file as indicated 

5 by block 1108-14, In the case of system log file 10-102e, daemon 10-110 calls the error ID search routine 
which looks for error ID parameters in the source's message template database which match the error ID 
parameter contained in the record just read from the system log file as indicated by block 1108-16. 

As indicated by block 1108-18, when a match is detected, daemon 10-110 updates the count parameter 
in the template database message for the message in which the match was found. Daemon 10-110 then 

10 checks for an overthreshold condition as indicated by block 1108-22. This is done by determining if the 
count in the template database message exceeded the configured count value previously obtained from 
source attribute control file 10-1 02b. When the count has been exceeded, daemon 10-110 executes the 
action configured for that particular source as indicated by block 1108-24. As previously discussed, in the 
preferred embodiment, there are two supplied actions, a mail notification action and a callout action. This 

75 results in daemon 10-110 invoking the mailact module 10-202, the callact module 10-218/10-312 of Figure 3 
or whatever action has been selected. 

Following that, daemon 10-110 continues on with reading messages. \A/hen there are no more 
messages to be read from the source log file by an end of file, daemon 10-110 returns to block 1114 of 
Figure lib. 

20 Figures 12a through 12c are used to illustrate the operation of callback component 10-400 relative to 

how the configured parameters as used to control its operation. Figure 12a illustrates diagramatically, the 
operational flow through the different configured subcomponents of callback component 10-400 when a 
remote user at TAG 14 dials into the host system 10. As shown, the operating system kernel and drivers of 
block 10-4 are utilized to allow the remote user called "remote" to dial back into the host system "getty" 

25 daemon. The getty daemon will accept the connection to host system 10 and spawn a shell for the user to 
run the remote user's profile file. In the present invention, the .profile file is a special .profile file 
corresponding to .profile module 10-403 which is part of RSF unit 10-10. The .profile module 10-403 
performs certain functions pertaining to callback component 10-400 such as starting callscript module 10- 
406. 

30 Figure 12b illustrates the sequence of operations performed by .profile module 10-403. As indicated in 

block 1202, module 10-403 performs a setup operation and starts callscript module 10-403. Also, .profile 
module 10-403 includes means for trapping remote user control signal sequences normally used to gain 
control of the host system. This operates as a security mechanism. 

Next, module 10-403 queries the mon.conf file 10-405 via confmon module 10-404 to read out set 

35 configuration parameters to determine what terminal TYPE is to be used for callback as indicated in block 
1204. If the TYPE parameter has been set, .profile module 10-403 will set the TERM environment variable 
in memory to the configured value. If there is no configured TYPE parameter, module 10-403 will use the 
default value. This completes blocks 1208 and 1210. It then displays any desired proprietary message (e.g. 
copyright notice) as indicated in block 1212 and then queries the mon.conf file 10-405 via confmon module 

40 10-404 to read out the configuration parameters for the E-Mail address to send notification of remote log-in 
and log-out operations as indicated in block 1214. if an E-Mail address has been preconfigured, module 10- 
403 sends notification to the configured address, notifying that a remote user has logged onto host system 
as "remote" as indicated in blocks 1216 and 1218. 

Next, as indicated by block 1220, module 10-403 queries the mon.conf file 10-405 via confmon module 

45 10-404 to read out the configuration parameters to determine whether or not any of the scripting options 
such as direct terminal, monitoring, interactive monitoring or session logging have been enabled. If direct to 
terminal monitoring has been enabled, module 10-403 builds a command line for callscript module 10-406 
containing ttie argument parameters which will support direct to terminal monitoring as indicated by blocks 
1222 and 1224. If session notification-interactive monitoring or session logging has been enabled, module 

50 10-406 will build a command line for supporting the corresponding scripting option as indicated by blocks 
1226 through 1232. Upon completing the building of the command line, module 10-403 next determines if 
there are any arguments on the command line for establishing if any one of the above scripting options has 
been enabled. If none of the options have been enabled, module 10-403 runs the GMIS unit 10-8 directly as 
represented in Figure 12a as a dotted line (i.e.. block 1238). However, if a scripting option has been 

55 enabled, module 10-403 will invoke the callscript module 10-406 and pass the argument parameters 
supporting the enabled option to it witfi a command specifying that callscript module 10-406 also run GMIS 
unit 10-8 as a subtask (see bk^ck 1236). 
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At this point, the GMiS unit 10-8 is running, the "renr^ote" user has logged Into the host systenn and is 
carrying out the required support operations. More specifically, when the "rennote" user has logged into the 
host system, the callback adnninistration nnenu of Figure 12d is presented to the '^remote*' user. As shown 
in Figure 12d, there are several selectable menu items. These include crash analysis, list overlhreshold 
5 messages, root login, user login and run GMIS. Selecting the crash analysis menu item is a privileged task 
requiring use of module 10-430. It causes the "crash" command utility of the host system to be run against 
the host system's primary dump device. The crash command requires "root" access and, therefore, is 
allowed or not allowed as a function of how permission subcomponent 10-422 has been preconfigured using 
the confperm command. 

10 The list overthreshold messages menu item when selected causes the generation of a list message 

command (Ismsg) with appropriate command line parameters. This causes Ismsg command program 10- 
106f of Figure 4a to cause a display of a list of all the overthreshold messages and the text of each 
message tht caused the overthreshold condition. 

The root login menu item is a privileged task requiring use of module 10-430. When selected, it spawns 

75 a "super user" shell from which the "remote" user can have access to all host system functions. Again, 
access to this menu item is granted as a function of how permission subcomponent 10-422 has been 
configured by the local system administrator via the confperm command. The "user login" menu item is a 
non-privileged task requiring use of module 10-432. When selected, an ordinary user shell is spawned from 
which the "remote" user can have access to user host system functions. 

20 The run GMIS menu item is a non-privileged task requiring the use of module 10-432. The selection of 
this menu item causes the GMIS unit main menu to be displayed to the "remote" user and allows ordinary 
user access to all of the functions available from the GMIS unit 10-8. 

When the remote user logs out. control is returned to .profile module 10-403 which performs the 
operations of blocks 1240 and 1242 before closing. It needs to send E-Mail notification of the logout. 

25 Therefore, it queries the mon.conf file 10-405 via confmon module 10-404 to determine if an E-Mail address 
has been configured (i.e.. block 1240). If it has, module 10-403 sends an E-Mail notification message to the 
configured address notifying the occurrence of the logout (see block 1242). it then will perform the required 
cleanup operations and exit. 

While the remote user is logged into host system 10, the remote user is running the GMIS unit 10-8. 

30 From this unit, the user has the option of running several different tasks, some of which are non-privileged 
and some of which are privileged. The system administrator on the host system is normally responsible for 
saying whether or not the remote user is allowed to run these privileged tasks. The running of such tasks is 
under the control of doremote module 10-424 which uses the configuration parameters stored in re- 
mote.conf file 10-426. Anytime the remote user attempts to run one of these privileged tasks, this invokes 

35 doremote module 10-424. This module runs as a setuid program on the UNIX based system which means 
that it is capable of obtaining super user privileges as it requires. Hence, it is able to bestow such privileges 
to run such privileged tasks. However, before carrying out such a task, it first examines the command line 
parameters to determine which privileged task is requested. It then queries the remote.conf file 10-426 to 
determine if the task is allowed. If it is not allowed, module 10-424 will print a permission denied error. If it 

40 is allowed, module 10-424 performs the task. This sequence of operations is shown in blocks 1250 through 
1260 of Figure 12c- 

Figures 13a through 13d as used to describe the hot key capability of callback component 10-400 
according to the present invention. Figure 13a diagramatically illustrates the operational flow of a hot key 
operation which will be described in connection with the flow charts of Figures 13b through 13d. In order to 

45 understand the hot key capability, it is helpful to understand how callscript module 10-406 operates. As 
previously discussed, callscript module 10-406 performs all of the actual scripting of the session when a 
remote user logs into host system 10. As indicated in blocks 1300 through 1306. when callscript module 10- 
406 starts up, it parses its command line arguments and determines what all of its inputs and outputs are. It 
then starts a subshell. If the provided command line has been set up to request the creation of a PID file, 

50 then callscript module 10-405 writes the PID of the subshell into PID file 10-407. As indicated in blocks 
1308 through 1340, it will then enter a main loop wherein it reads from its inputs and writes to its outputs. At 
the same time, it checks to see if the subshell has exited. When the subshell exits, callscript module 10-406 
performs cleanup and exits. 

While these operations are taking place, the local administrator upon receiving notification of the 

65 occurrence of the remote user login may want to monitor the current session initiated by the TAG. The 
administrator does this by running "showses" module 10-412 via terminal 10-12 as indicated in Figure 13a. 
When invoked, showses module 10-412 executes the sequence of operations shown in blocks 1350 through 
1356 of Figure 13c. 
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As indicated, module 10-412 checks for the current session file in file 10-408. If the current session file 
does not exist, it displays a message saying there is no current session. If the current session file exists, 
module 10-412 invokes showscript module 10-414 and passes the proper arguments to it for monitoring that 
current session file. It also passes to module 10-414, the PID obtained from PID file 10-407. 

5 Showscript module 10-414 performs the sequence of operations indicated in blocks 1360 through 1374 

of Figure 13d. As shown, the module parses Its command line arguments, reads from session file 10-408 
and writes to the local system administrator terminal 10-12. While it is reading from session file 10-408 and 
writing to terminal 10-12, showscript module 10-414 also checks to see if anyone is typing on the keys of 
local administrator console 10-12, 

70 Because the administrator can hit a "hot key" to terminate the session, module 10-406 checks to see if 

any key has been selected. If the "k" key has been selected, this signals showscript module 10-414 that it 
has to terminate the session. In so doing, module 10-406 first checks if the PID was specified on the 
command line which it would have been because that is how showses module 10-413 executes. That is. 
showses module 10-413 is programmed to read the PID from file 10-407 and pass it to showscript module 

75 10-414. Upon seeing that the PID is specified, module 10-414 sends a "kill" signal to GMIS unit 10-8 as 
indicated in Figure 13a. If the key selected is not the "k" key but the "Q" key, module 10-414 performs 
cleanup operations and exits. By having the modules of Figure 13a operate in the described manner, this 
provides the local administrator with a hot key capability thereby providing the local user with greater 
control over callback sessions. 

20 From the above, it is seen how the RSF components of the present invention can be configured and in 

turn how such configuration information controls the operations of such components. The organization of the 
RSF unit into such basic components facilitates configuration as well as expansion. According to the 
teachings of the present invention, each component can be configured with a small manageable set of 
commands. Also, new sources can be easily added or deleted and any action program can be easily 

25 specified to perform any desired type of support notification operation. 
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APPBHDIZ 

SECTION X DEgCRIPTION OF COMMMTOS 
AND COMMAND PROGRAMS 



X. callact Module 



Syntax: 

callact source_idcntif ier description_f ile 
message_identif ier 

Description 

Callact is a utility which executes an action (i.e., it 
may be configured as an action that is taken by the RSF 
unit when an over-threshold condition occurs) . The 
callact action sends a callout record to a response 
center location according to the parameters configured 
with the callcfg command. 

If configured for a standalone host system which has a 
modem attached, callact will use the callout manager 
module (see xakcall) to send a callout record to a 
response center. In a clustered host environment (where 
there is one machine with a modem and several other LAN 
connected machines which share that modem over the 
network) callact may redirect callout requests to the 
callout manager on a specified central node which has a 
modem which is used, in turn, to call a response center. 

The callout record that is sent to the response center 
is created by callact and includes the following items: 

Current date and time 

Site callout configuration (phone nximbers, system 
ID, etc.) 

The text of the over threshold message: 
••description_f ile" 

Information about the operating system (uname -svr) 
Information about hardware configuration (Iscfg -y) 

Callact may also be configured to send mail to a given 
E-Mail address whenever a callout is made. 
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This utility is not used from the command line or from 
GMIS. It is invoked by rsfd daemon process as an 
action* 

Options 

source_identif ier Which monitored source is involved 

with this action. 

description_f ile File containing text of over- 
threshold message. 

message_identif ier ID of the message that is over- 
threshold* 

Related Information: 

The following commands/prograuns : callcfg, calif orce, 
netact, netactd, netcall, mkcall, Iscall, rmcall, 
chcall, calld, callout, callbin. 



2« callbin comaand Program 



Syntax: 

callbin -p primary-code -s secondary-code -f file 
-S "site^inf ormation" 

Description 

Callbin uses a modem to communicate with a response 
center to deliver RSF messages. This is a lower level 
program, not meant to be run from the command line or 
from GMIS, but which is called from the ••callout" 
script. 

The primary and secondary error codes provide the 
following high level information eU30ut the message being 
sent. 

primary Code Secondary Code Meaning 



0x0001 
0x0001 
0x0001 
0x0001 
0x0002 



0x0000 
0x0001 
0x0002 
0x0003 
0X0000 



Undetermined Error 
Hardware Error 
Software Error 
Operator Message 
Forced Callout 



This command progrsua uses pareuaeters configured with the 
callcfg command to control telephone numbers dialed, the 
tty port of the modem used, modem control strings used. 
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site identification information sent to the response 
center, and other configurable parameters such as 
delays, retries, and tracing controls. 

This command program relies on its wrapper, "callout", 
to ensure that the modem is not in use by another 
application (such as ate, or cu) • 

The contents of the specified file are sent to the 
response center as the "free-form buffer" of the callout 
record. There is an imposed 65 Kilobyte maximim length 
for the data in this file. If the file is larger, the 
message will be truncated. 

If "site_information" is not provided, the local site 
information (as configured with callcfg) will be sent in 
the callout record. The -S option is used to specify 
site identifier information for LAN connected RSF 
"cluster clients". 

Options 

-p primary-code Hexadecimal Primary Error Code 

(see above table) 

-s secondary-code Hexadecimal Secondary Error Code 

(see eUsove table) 

-f file File specifying content of callout 

record 

-S "site_information" Site identifier (from cluster 

clients) 

Related Information: 

The following commands/programs: callcfg, callact, 
callforce, netact, netactd, netcall, mkcall, Iscall , 
rmcall, chcall, calld, callout. 
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3. callcfg Comnand 



syntax : 



15 



25 



30 



callcfg [ opphone= • phone number • ] 
[ opneu&e» ' opera t:or namB ' ] 

[mail='inail addr'] [ sysphone- • phone number*] 
[passwd= • password • ] [suptype='RC or SO*] 
[siteid='SC site'] [inodel=«SC model*] 
[serial='SC serial #•] [tac»*SC tac char'] 
[ sy s id- • RC system ID • ] 
[calltype^* modem or network'] 
[ server= ' cluster server • ] [ tty= • tty path • ] 
[cbits=' character bits'] [sbits='stop bits'] 
[parity* ' line^ parity • ] [baud- • baud rate • ] 
[mnp='yes or no'] 

[condout='callout conditioning string'] 

[condin=' callback conditioning string'] 

[dial='dial string'] 

[ ( add del } phone ' phone ntxmber ' ] 

( { add del ) ok • ok string ' ] 

[{add del) connect 'connect string'] 

[ redo= ' redo string ' ] 

[disconnect^ ' disconnect string ' ] 

[h2mgup=' hangup string*] [busy^'busy string*] 

[tryphone— 'retries per each phone nximber'] 

[trycondition-»* retries conditioning modem'] 

[comdelay—' modem inter-command delay*] 

[busydelay«* delay between busy retries*] 

[remdelay=' remote latency delay*] 

[ remt imeoutss • remote time out • ] 

[tracelevel«' 0-10' ] [tracef ile«' pathname • ] 

[-S] [-m] [-t] [-a] 



35 



40 



Description 

The callcfg command is used to set and display all of 
the parameters relating to the autodial function 
including those used on cluster clients. The various 
options are explained below. There are GMIS menus for 
this commands Use the GMXS fastpath ••brc^callout*' for 
local modem configuration, or "brc^cluster^callout** for 
cluster client configuration. 



45 



50 



Options 
opphone= 



opname* 



Sets the phone number of the local system 
administrator. This information is 

included in all callout records set to the 
response center . 

Name of the local system administrator. 
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inail= 



passvd== 
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suptype= 
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sysid'= 



si'teid'' 



models 



serials^ 



t:ac= 



so 



calltype* 



This information is included in all callout 
records set to the response center. 

E-Mail address to which notification of all 
callouts from this system will be posted. 
No E- Mail will be sent if this parameter 
is set to (the empty string) • 

Sets the published password of the "remote" 
account as it is sent to the response 
center in a callout record. Setting this 
parameter DOES NOT actually set the login 
password on "remote". Setting the login 
password is a separate operation. This 
parameter is optional, but should be set to 
the real password of "remote" if call-back 
support is desired and should be changed to 
the current password whenever the password 
of "remote" is changed. 

This parameter sets the type of response 
center protocol that will be called when a 
callout occurs. Set this parameter to "RC" 
for RC response centers or "SC" for SC 
response centers. If set to RC, the 
"sysid" parameter must also be set. If set 
to SC, the following parameters must also 
be set: siteid, model, serial, tac. 

This parameter sets the system identifier 
for this system. This parameter is required 
only for use with RC response centers. 

This parameter sets the site identifier for 
this system- This parameter is required 
only for use with SC response centers. 

This parameter sets the model name of this 
system. This parameter is required only 
for use with SC response centers. 

This parameter sets the serial niunber of 
this system. This parameter is required 
only for use with SC response centers. 

This parameter sets the Technical 
Assistance Center (TAC) ID of the 
responsible TAC. This parameter is 

required only for use with SC response 
centers. 

If set to "modem" this configures the 
autodial facility to work with a local 
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modem (attached to this machine) , If 
"modem" callout is configured then the 
following other callcfg parameters must 
also be set: tty, cbits, sbits, parity, 
baud, mnp, condout, condin, dial, redo, 
disconnect, hangup, busy, tryphone, 
trycondition, comdelay, busydelay, 

remdelay, remtimeout, tracelevel, and 
tracefile, BRC phone number (s) , OK strings 
and connect strings. If set to "network" 
then this machine is assumed to be a 
cluster client which, lacking a modem of 
its own, must use a cluster server to 
perform the callout- If "network" callout 
is configured then the "server" callcfg 
parauaeter must also be set. 

This parameter sets the host:neune of the 
cluster server machine* This parameter is 
required only when calltype-network. 

This parameter sets the TTY device (e.g. 
/dev/ttyl) that will be used for callout 
and call -back. The port for this device 
must have a modem attached and should be 
configured as a shared line if call-back 
support is desired. 

This parameter sets the phone number that 
may be used to call back to this system. 
This is the phone number of the modem 
attached to the port associated with the 
device specified with "tty*". 

This parameter sets the number of bits (5— 
8) per character that are used when 
communicating with the response center. 

This parameter sets the number of stop-bits 
(1/2) that are used when communicating with 
the response center. 

This parameter sets the parity setting 
(none, even, odd) that is used when 
communicating with the response center. 

This parameter sets the baud rate (e.g. 
1200, 2400, 4800, 9600) that is used when 
communicating with the response center. 

This parameter sets whether or not the 
modem being used is a modem network 
protocol (MNP) type of modem. These modems 
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20 



require an extra disconnect comnand when 
closing a connection. 

condout« This parameter sets the modem conditioning 

string that is used when conditioning the 
modem for call out. 

condin= This parameter sets the modem conditioning 

string that is used after a callout to make 
the modem ready to accept calls back. 

dial= This parameter sets the modem control 

string that will be used to dial out. 

(add I del) phone 'phone nximber' This syntax is used to 
add or delete phone numbers from the list 
of response center phone numbers. E>uring a 
callout these numbers will be tried in 
sequence until a successful connection is 
made. 



25 



(add I del) ok "ok string' This syntax is used to add 
or delete strings from the list of possible 
"OK" strings that may be returned by the 
modem. 



{add I del) 



30 



redo* 



35 



connect 'connect string' This syntax is 
used to add or delete strings from the list 
of possible ••connection achieved" strings 
that may be returned by the modem. 

This pareoaeter sets the modem control 
string that will be used to retry the dial 
out command in the event of a failed 
connection. If the modem being used does 
not support a redo command then set this 
parameter to (the empty string) . In this 
case the entire dial out command will be 
re-sent to the modem on a retry. 



40 



disconnect= 



This parameter sets the modem control 
string that will be used to end a modem 
connection. 
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hangup- 



busy= 



tryphone- 



This parameter sets the modem control 
string that will be used to hang up after 
ending a modem connection. 

This parameter specifies what string to 
expect from the modem if the dialed number 
is busy. 

This parameter sets how many times to retry 
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making a connection vit^i each telephone 
number if the connection fails for any 
reason . 



trycondition= This parameter sets how many times to retry 
conditioning the modem if modem 
conditioning should happen to fail. 

comdelay* This parameter sets the nximber of seconds 

to pause before sending commands to the 
modem. 



busydelay= This parameter sets the number of seconds 
to wait between retries making a connection 
if the connection failed because the phone 
was busy. 

remdelay^ This parzuneter sets the number of seconds 
to wait before sending data to the response 
center. 



remtimeout^ This pareuneter sets the number of seconds 
to wait for data from the response center 
before giving up. 

Example 

To set the local system administrator's name to "John 
Smith", add a phone number to the list of response 
center phone numbers, change the delay between retries 
on each phone number to 1 minute, and then display the 
complete configuration: 



callcfg opname«"John Smith" add phone 5553421 
busydelay=60 -a 



Files 



/var/ call/ call. conf A binary file which stores the 

configuration managed by this command. 

Related Information: 

The following commands/programs: callact, call force, 
netact, netactd, netcall, mkcall, Iscall, rmcall, 
chcall, calld, callout, callbin. 



4. calld Daemon Program 



Syntax: 



06323e2A1_L> 



32 



EP 0 632 382 A1 



calld 

Description 

The RSF callout manager program controls ^e sequencing 
and timing of callouts to a response center. It manages 
a queue of callout requests* The queue is manipulated 
with the mkcall and rmcall commands. Requests and 
parauneters are viewed with the Iscall command. 
Configuration pareuneters are set with the chcall 
command • 

This daemon controls the timing of callout requests 
according to the parameters configured with chcall . 
Callout requests are serviced on a first-come- first- 
serve basis. The calld daemon is started and stopped 
using the chcall command. 

A log of all callout requests executed by the callout 
manager daemon is kept in /var/call/callout . log. 

Files 

/var/call/calls/call.ctrl A binaary file which stores the 

callout metnager queue and 
configuration parameters. 

/var/call/callout.log Log file listing all callouts 

invoked by the callout 
management daemon and the 
results of each. 

Related Information: 

The following commands/progreuas : callcfg, callact, 
calif orce, netact, netactd, netcall, mkcall, Iscall, 
rmcall, chcall, callout, callbin. 



5. calif orce Command Program 



Syntax: 

callforce [-b] [-f file] 
Description 

Callforce sends a callout record to a response center 
according to the pareuneters configured with the callcfg 
command • 

This command progreun is normally used for testing 
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purposes . 

If a file is specified with the -f option then the 
5 contents of the file are sent as a part of the callout 

record, otherwise a text editor is invoked (using the 
EDITOR environment variaUble or "vi" as a default) and 
the message to be sent may be entered « 

If configured for a standalone host system which has a 
modem attached, callforce will use the "callout" program 
to send a callout record to a response center. In a 
clustered environment (where there is one machine with a 
modem and several other LAN connected machines which 
share that modem over the network) callforce may 
^5 redirect callout requests to the cluster server 

configured with callcfg. 

The callout manager program is bypassed for forced 
callouts. This implies a higher priority for forced 
20 call outs. 

The callout record that is sent to the response center 
is created by callforce and includes the following 
items : 

Current date and time 

Site callout configuration (phone numbers, system ID, 
etc. ) 

The message to be sent 

Information about the operating system (uname -svr) 
30 Information about hardware configuration (Iscfg -v) 

This utility is used from the command line. It is not 
available from GHIS. 

35 Options 

-b Do the callout in the background. 

-f file Use the contents of the specified file as the 
^ message to send . 

Example 

To send the contents of a file to a response center 
^5 callforce -f message, file 

Related Information: 

The following commands/programs: callcfg, callact, 
50 netact, netactd, netcall, mkcall, Iscall, rmcall, 

chcall, calld, callout, callbin. 
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6. callout Command Program 
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Syntax: 

callout -p primary-code -s secondary-code -f file 
-S "sit:e_information»» [-bdr] 

Description 

This program is a wrapper for the "callbin" program 
which uses a modem to send a message to a response 
center- This wrapper script manages the modem's tty 
port. 

If the tty port is in use by another application (such 
as ate or cu) , callout will either wait until the line 
becomes free, or put itself in the background and wait 
for the line to become free, depending on the given 
arguments . 

While callbin is using the line the tty will be disabled 
and then reset to its previously configured state when 
callbin is finished. 

This program is not meant to be executed from the 
command line or from GMIS. It is called from the callout 
manager daemon (calld) , the RSF daemon (rsfd) , and the 
netcall and calif orce scripts. 

see callbin for information about the -p, -s, -f, and -S 
options. 



Options 

-p primary-code 
-s secondary-code 
-f file 

-S "site_information» 
-b 



50 



Hexadecimal Primary Error Code 
(see callbin) 

Hexadecimal Secondary Error Code 
(see callbin) 

File specifying content of callout 
record (see callbin) 

Site identifier (see callbin) 

R\in callout in the background 
whether or not the line is 
currently in use by another 
application 
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-d Print: a message and run callout: in 

the background if the line is 
currently in use by another 
application 

-r Remove the file specified by -f 

when callbin is finished. 

Files 

/etc/locks/LCK. .* Lock files used to synchronize access 

to serial lines 

Related Information: 

The following commands/programs: callcfg, callact, 

calif orce, netact, netactd, netcall, mkcall, Iscall, 
rmcall^ chcall, calld^ callbin* 



7 . callscript Command Program 



Syntax : 

callscript [•c command] [-f file] [-t tty] 
[-S session_f ile] 
[-1 ctrl_file] 

Description 

This command progreua is used to support the RSF call- 
back environment • s remote session scripting/mirroring 
features • 

The standard script command program allows only a user 
shell to be scripted. This command program allows a 
command to be specified on the command line. When the 
specified commemd exits the scripting session completes. 
If no command is given, callscript uses the current 
user's $SH£LL, or /bin/sh. 

The -f, -t, and -s options allow files/devices to be 
specified as destinations for scripted data. Each 
option represents a different form of scripting (see 
below) • Any of these options may be specified multiple 
times with different destinations (e.g. callscript -f 
filel -f file2). 

This command program is not used directly by RSF users 
and is not available from GMIS. 

Options 
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-c comnand Runs "the specified comnand instead of 

user*s shell* 

5 -f file Standard "script" comnand style output* 

Verbatim copy of all data sent to, 
received from the user's terminal 
including control codes and carriage 
returns . 

10 

-t tty Mirrors the session on the terminal 

associated with the specified tty 
device* The tty may be a real tty (e.g. 
"/dev/ttyl") or a pseudo-tty (e.g. 
"/dev/pts/4") . The specified tty will 
be put into "raw" mode for the duration 
of the mirroring and will be put back to 
its original state when the session is 
over. 

-s session_file Writes a file in a special format that 

includes timing information. This kind 
of file can be played back like a movie 
using the "showscript" command. The 
showscript command program can also be 
25 used to strip the timing information 

out. This results in a regular script 
file. 
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-1 ctrl_file If this option is given, the PID of the 

command program being scripted is 
written to the specified file. 

Example 

To script a curses GMIS session to a session file named 
"session" . 

callscript -c smitty -s session 
Related Information: 

The following c ommands/ programs : confperm, doremote, 
confmon, callscript, showscript, showses, Islses, 
showlses , rmlses 

8. chcall command 



Syntax: 

50 

chcall [-d delay] [-m maxcalls] [-n] [-r] 
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[ -s ( now I reboot j both ) ] 
[ -X { now I reboot | both ) ] 



Description 

The RSF callout manager controls the sequencing and 
timing of callouts to a response center. It manages a 
queue of callout requests. The queue is manipulated with 
the mJccall and rmcall commands. Requests and parameters 
are viewed with the Iscall command. The queue is 
serviced by the callout manager daemon (calld) . 

This command is used to configure parauneters that are 
16 used by the callout manager daemon (calld) to control 

when callouts will be taken off of the callout manager 
queue and sent to a Bull Response Center. 

The delay specified with the -d option controls the time 
20 interval between sending callouts when there are 

multiple callouts in the queue. This delay keeps the 
modem from being "hogged" when there are many callout 
requests that occur within a small period of time. The 
delay allows a remote service representative to log in 
(if configured). If the delay is set to "Infinite" then 
the callout manager daemon will not start another 
callout until the "chcall -n" command is run. If the 
delay is set to "None" then callouts will always be 
started the moment they are enqueued. Other valid 
delays are of the form { 1-999} -{hours | mins | sees). 

30 

The maxcalls parameter specified with the -m option sets 
an upper limit on the length of the callout manager 
queue. If the number of items in the queue reaches this 
number then no more callout recpiests may be enqueued 
35 until items are taken off the queue by rmcall or calld. 

The -n option will cause the next callout request on the 
queue to be started. This is normally used when the 
delay parameter is set to "Infinite" and manual 
^ intervention for callout request processing is desired. 

The -r option will re-start callouts that have failed. 
When calld executes a callout request and the "callout" 
command fails, the callout remains in the callout 
manager queue with a status of "F". These callouts may 
be tried again (presumably after the problem that caused 
the callout failure has been rectified) by running 
"chcall -r". 

The -s and -x options are used to start and stop the 
50 callout manager daemon (calld) and to configure whether 

or not this daemon should be started automatically at 
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10 



16 



boot time. The -s option starts calld and the -x option 
stops calld. 



This command is available 
fastpath is "brc^callman" . 



from within GHXS. 



The 



Options 

-d delay 
-m maxcalls 



-n 
-r 

-s when 
-X when 



Set the delay between callouts 

Set the max. length of the callout 

queue 

Start the next callout 
Re-start failed callouts 
Start the callout memager daemon 
Stop the callout manager daemon 



manager 
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Example 

To se^ 'the delay between calloutis to 10 minut:es: 

chcall -d 10-mins 

Files 

/var/call/calls/call,ctrl A binary file which stores tJie 

call out: manager queue and 
configuration parameters. 

Related Information: 

The following commands/programs: callcfg, callact, 
calif orce, netact, netactd, netcall, mXcall, Iscall, 
rmcall, calld, callout, callbin* 

9. chmsg command 

Syntax : 

chmsg -n source_identif ier -I message__identif ier 
[{-i newid | -e expression}] [-t threshold] 
[-d duration] [-k )ceepmax] [-r] 

Description 

The chmsg command is used to modify the attributes of a 
monitored message in the RSF unit. The identifier of the 
message and the identifier of the source to which it 
belongs are required options. The following attributes 
of the message can be changed with this command: 

message id This is the hexadecimal identifier used by 
the RSF unit to differentiate between 
messages. 

expression This is the regular expression used for 
pattern matching log messages. For ex2u&ple, 
consider the following fictional log 
messages : 

BUS ERROR: CONTROLI*ER NUMBER 5 
BUS ERROR: CONTROLLER NUMBER 6 

Although these two messages are not 
syntactically identical, they are both 
reporting a problem with the bus. The RSF 
unit uses regular expressions to match these 
messages together. 
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The following regular expression could be 
used to categorize all bus errors 
regardless which controller failed: 

"BUS ERROR rCONTROLLER NUMBER 

threshold This is the integer number of a given 
message which the RSF unit must record 
before it will perform an action. When the 
threshold has been reached, the next message 
of that type will result in an action, 

duration This is the time period during which a given 
threshold must be exceeded to result in an 
action. For example, the RSF unit may be 
configured to perform an action if message x 
is detected n times during time duration t. 
The duration must be specified as follows: 

{ 0-999 }- {days | hours | mins) 

keepmax This will specify the maximum number of the 

given message that will be stored by the RSF 
xinit. This will eliminate the possibility 
of runaway error messages creating a runaway 
RSF database. 



Options 

-n source_identif ier Specifies the identifier of 

the source. 

-I message_identif ier Specifies the identifier of 

the message. 

-I new_message_identif ier Specifies the new id for the 

message • 

-e expression Specifies the new regular expression for 
the message. 

Specifies the new threshold value for the 
message. 

Specifies the new duration value for the 
message. 

Specifies the new keepmax value for the 
message. 

Resets the message count to zero. 



-t threshold 
-d duration 
-k keepmax 
-r 
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Example 

To change message FFFFFFFF for source "test source" to 
^ have a threshold of 25 and a duration of 1 day: 

chmsg -n testsource -I FFFFFFFF -t 25 -d 1-day 

Related Information: 

10 The following commands/programs: chrsf, chmsrc, rsfd, 

Ismsg, Ismsrc, mJansg, mJonsrc, rxmnsg, rmmsrc, netact, 
netactd. 



10 « chmsrc Command 

Syntax: 

chmsrc -n source_identif ier [-i new_source_identif ier] 
20 [-t type) [-p path] [-a action] [-c cleantime] 

[-S searchtime] [-f initialization^f ile] [-b] 
[-U] [-e] [-r] 

Description 

25 

The chmsrc command is used to modify the attributes of a 
monitored source in the RSF unit. The identifier of the 
monitored source is a required option. The following 
attributes of the source can be changed with this 
command : 

30 

source identifier This is the ASCII identifier 

specified by the user for the 
monitored source. 

35 type This is the type of the source. It 

can be either ASCII or SYSTEM. A 
SYSTEM source is the system log and 
an ASCII source can be any log file 
in ASCII format. 

40 

path This is the path to the source^ or 

log file, to be monitored. 

action This is the path to the action 

which will be executed when the RSF 
unit detects that a message has 
gone over threshold. 

cleantime This is the time interval at which 

the RSF database is flushed. The 
50 following format is required for 
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the t:ime interval: 

{ 0-999 )- {days | hours 



mins} 



searchtime 



initialization file 



This is the time interval at which 
the source, or log file, is scanned 
for new messages « The following 
format is required for the time 
interval : 

{0-999} -{days | hours | mins) 

This is a file which specifies a 
list of messages to be monitored by 
the RSF unit on the given source. 
An example of the required format 
is given below for both ASCII and 
SYSTEM sources. Lines beginning 
with # are comments: 



For an ASCII source: 



# express ion 
system_error . * 



threshold 
2 



duration 
1-day 
4 -days 



i/o_error_on_device . * 5 

For a SYSTEM source 



fid 

23e44f 
abode f 

action blocking 
action log 
reset 
Options 

-n source identifier 



threshold 
2 

10 



duration 

1- day 

2 - hours 



keepmax 

50 

10 



keepmax 

50 

10 



The action associated with a source 
can be blocked from executing. 

The record of actions associated 
with a soxxrce can be erased. 



The count of over 
messages can be reset. 



threshold 



Specifies the identifier of the 
source to be changed. 



-i new_source_identif ier Specifies the new identifier 

for the given source. 



-t type 
-p path 



Specifies the new type of the source- 
Specifies the new path to the source. 
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-a action Specifies the new action for the 

source • 

-c cleantime Specifies the new cleantime. 

5 

-s searchtime Specifies the new searchtime 

-f initialization_f ile Specifies the path to the 

initialization file. 

10 

-b Blocks the action associated with this 

source . 

-u Unblocks the action associated with 

75 this source. 

-e Erases record of actions for this 

source . 



20 



25 



30 



-r Resets counts of over threshold 

messages for this source. 

Example 

To modify the source "testsource" to scan the log files 
every 5 minutes and erase the action log: 

chmsrc -n testsource -c 5-mins -e 

Related Information: 

The following commands/progreuas : chrsf, chmsg, rsfd, 
Ismsg, Ismsrc, mkmsg, mkmsrc, rmmsg, rmmsrc, netact, 
netactd. 
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11* ehrsf Command 



Syntax: 



45 



chrsf {-s { now | reboot | both } | -x { now j reboot | 
both } } { -a { now | reboot | both ) | -n { now 
I reboot | both)} 

Description 

The chrsf command is used to start or stop the RSF 
daemon and the netactd daemon. The daemons can be 
started or stopped in three different ways: 

now perform startup/ shutdown now. 

reboot perform startup/ shutdown at reboot time. 

both perform startup/ shutdown now and again at 

reboot time. 

Options 

•s Starts the RSF daemon. 

-X Stops the RSF daemon. 

-a Starts the netactd daemon. 

-n Stops the netactd daemon. 

Exaunple 

To start the RSF daemon at reboot time: 
chrsf -s reboot 

To stop the netactd daemon now: 
chrsf -n now 

To start the RSF daemon and the netactd daemon now: 
chrsf -s now -a now 
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Related Information: 

The following commands/progrsuns: chmsg, chmsrc, rsfd, 
Ismsg, Ismsrc, mJoasg, mJansrc, rmmsg, rmmsrc, netact, 
netactd* 



12. confdiag command 



Syntax: 
confdiag [-s 
Description 



-X ] [-t frequency] [-q] 



The RSF xinit may be configured to test itself 
periodically • If enabled, a diagnostic routine will 
force a message to be written to the system log file* 
The RSF unit is set to monitor the system log file for 
this message and will perform a callout as soon as it is 
detected by the RSF daemon • This feature allows the 
system administrator to confirm that the RSF unit is 
actually detecting messages. If callout(s) are not made 
periodically when this feature is enabled, this is the 
first diagnosis that the RSF unit is sick. 



Options 
-s 

-X 

-t frequency 

-q 

Defaults 



Enables the diagnostic message injection. 

Disables the diagnostic message injection. 

Specifies the frequency of the diagnostic 
message injection to be performed by the 
RSF daemon . Valid settings are DAILY , 
WEEKLY, BIWEEKLY, MONTHLY, and BIMONTHLY. 



Displays the cxirrent 
diagnostic feature. 



status 



of 



the 



If no options are provided, the default option is -q. 
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Examples 

1. To enable the diagnostic feature with a weekly 
frequency: 

confdiag -s -t WEEKLY 

2. To disable the diagnostic feature: 
confdiag -x 

Related Information : 

The following commands/programs: chrsf^ chmsg, chmsrc, 
rsfd, Ismsg, Ismsrc, mkmsg, rmmsg, rmmsrc, netact, 
netactd . 



13. confmon Command 



Syntax: 

confmon [-d] [-x] [-t device] [-s] [-n] [-m device] [-e] 
[-f] [-a address] [-1] [-g] [-c TermType] 
[ -DS AliTO] 

Description 

This command is used to configure the session scripting 
features of the RSF call-back environment. With 
session scripting enabled all characters sent and 
received to/ from the remote user"s terminal is captured 
and echoed to one or more destinations depending on the 
configuration. This can be used by the local system 
administrator to watch everything that is being done by 
the remote user to preserve system security. There are 
three forms of session scripting that are supported: 

Direct-to-Terminal Scripting 

With this form of scripting the moment a remote 

user logs in on the system a specified terminal is 

immediately taken over and a mirror of the remote 
user's terminal is displayed. 

S ess i on-Not i f icat ion- Interactive Scr ipt ing 

With this form of scripting, when a remote user 
logs in on the host system, a warning message is 
sent to the specified terminal. Once warned the 
local system administrator may run a command to 
view a mirror of the remote session. In this mode 
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if the 'K' key is hit the remote user will be 
iitonediately logged off the host system. 

Session Logging 

With this form of scripting a file is created which 
contains a script of the remote user's session. 
There will be one such file for each time the 
remote user logs in. These files are stored in 
/var/call/sessions and are named based on the 
date/time of the login. These files may be listed, 
played back, and removed with the Islses, showlses, 
and rmlses commands. 

All three of these scripting options may be turned on 
and off independently. 

The -d option turns on direct-to-terminal scripting ^ the 
-X option turns it off. The -t option configxires the tty 
device to which the remote session should be copied. 

The -s option turns on session-notification-interactive 
scripting, the -n option turns it off. The -m option 
configures the tty device to which the warning about 
remote user login should be sent. 

The -e option turns on E-mail notification. With this 
enabled, an E-mail message is sent to the address 
specified with -a whenever the remote user logs in and 
out. The -f option turns off E-mail notification. 

The -1 option turns on session logging, -g turns it off. 

The , -c option is used to specify the terminal type 
($TEBH) that must be used for call-back. This parameter 
is important because scripted sessions may be viewed 
only on a terminal that is equivalent to the terminal 
being used by the remote user. Using this parameter, 
the local system administrator configures the type of 
terminal on which the administrator plans to view 
scripted sessions. The remote user is then forced to 
use a terminal or terminal emulator that is equivalent 
to the configured terminal type. 



Note: if Direct-to-Terminal scripting is enabled the -c 
option should be set to the terminal type of the 
45 terminal attached to the specified tty port. 

This command is available from GMXS. The fastpath is 
"conf_mon" . 

50 Options 
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-d 

-X 

-t device 
-n 

-m device 

-e 

-f 

-a address 
-1 

-g 



Turn on direct-to-terminal scripting 

Turn off direct-to-terminal scripting 

Specify the tty device to use for direct- to- 
terminal scripting 

Enable session-notification- interactive 
scripting 

Disable session-notification- interactive 
scripting 

Specify the tty device to use for session- 
notification- interactive scripting 

Turn on E-mail notification 

Turn off E-mail notification 

Specify the E-mail address to use for E-mail 
notification 

Turn on session logging 

Turn off session logging 



-c TermType Specify the terminal type that must be used 
for callback 



-D 



Display 
enabled 



direct-to-terminal 



device , 



if 



35 



40 



45 



-S 



-A 



-L 



-T 



-O 

Example 



Display session-notification-interactive 
device, if enabled 



Display E-mail address, 
notification is enabled 



if 



E-mail 



Display ••Y" if session logging is enabled, 
"N" otherwise 

Display the terminal type configvired with 
the -c opt ion 

Command to discover (used by GMIS) 



50 



To disable direct-to-terminal scripting, enable session- 
notification- interactive scripting on the console, 
enable E-mail to user "phoenix" on system "hazel" when 
remote users login/logout, and set the call-back 
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terminal type to vtlOO: 

confmon -x -s -m /dev/console -e -a phoenixShazel -1 -c 
VtlOO 

Files 

/var/call/mon.conf A binary file which stores the 

session scripting configura-tion 
parameters • 

/var/call/sessions Directory where date-stamped logged 

session files are kept. 

Related Information: 

The following commands/programs: confperm, doremot:e, 
confmon, callscript, showscript, showses, Islses, 
showlses, rmlses. 



14. confperm Command 



Syntax: 

confperm [-r] [-n] 
Description 

This command allows the local system adminls^trator of a 
system to control whether or not remote users will be 
granted root access* This applies to the "Crash 
Analysis" and "Root Login" items on the "Callback 
Administration" menu that is presented to remote users 
when they log in* 

If the -r option is used then future recjues^s for root, 
access will be granted* If the *->n option is used then 
future recpiests for root access will be denied* 

This command is available from within 6MIS* The 
fastpath is "conf_perm"* 

Options 

-r Allow future root access requests 
-n Deny future root access requests 
Exeimple 

To allow root access run the following command as root: 
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confpeinn -r 
Files 

/var/ call/remote. conf A binary file which stores 

permissions configuration 
parameters • 

Related Information: 

The following commands/programs: confperm, doremote, 
confmon, callscript, showscript, showses, Islses, 
showlses, rmlses. 



15 • doraaote Commaind 

Syntax : 
doremote -r 
Description 

If root access is allowed then a root stib^shell will be 
spawned. Otherwise an error message is printed and root 
access is not granted* 

The only valid option is -r and it must be supplied. 

This command is not meant to be xxxn from the command 
line. It is run from the GMXS "Callback Administration" 
menu that is presented to remote users when they log in 
using the RSF call-back environment. 
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Options 

-r Request root access 
Example 

To request root access: 

doremote -r 

Files 

/var/ call/ remote. conf A binary file which stores 

permissions configuration 
pareuneters • 

Related Information: 

The following commands/programs: conf perm, doremote, 
confmon, callscript, showscript, showses, Islses, 
showl ses , rmlses • 



16. Is call command Program 



Syntax: 

Iscall C-n #] [-a] [-N] Iscall { -c | -O } 



Description 

The • RSF callout manager controls the sequencing and 
timing of callouts to a response center. It manages a 
queue of callout requests. This queue may be manipulated 
using the mkcall and rmcall commands. The queue is 
serviced by a daemon process (calld) • Parameters 
relating to this queue may be set with the chcall 
command. 

Running Iscall with no argximents will show the list .of 
queued callouts along with a header that describes each 
of the columns. See the following example. 

Date Time Origin Condition 



1 S 12/14/92 15:09:52 jonathan RSF DIAGKOSTIC MESSAGE 
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The first two items "1" and "S" are the callout request 
ID and the callout status. The callout request ID is a 
number that may be used to reference a particular 
callout when using rmcall or -n option of Iscall. The 
callout status may have the following values: 

W Waiting for the calld daemon to service this 
request. Requests are serviced on a first- 
come-first— serve basis. 

S Started. The callout is in progress. 

F Failed. An earlier callout attempt has failed. 
Failed callouts remain in the queue and may be 
restarted with the "chcall -r" command. 

The date and time fields represent when a callout 
request was queued with the mkcall command. The origin 
field shows the name of the system that generated the 
callout request. The condition field shows a short 
description of the reason for the callout request. 

I f the " -n # " option is used then information will be 
shown for the callout with the given request ID only. If 
the -N option is used the the header will not be 
displayed. If the -a option is used then the contents of 
the callout record will be displayed. Use -n and -a 
together to look at the callout record for a particular 
callout. 

If the -c option is used then callout manager status 
will be shown as follows: 

De 1 ay : 4 -mins 

Call's: O 

Max calls: 20 

Next Call: Immediate 

The following explains the meaning of each field: 

Delay The time interval that should be allowed 

between sending callouts when there are 
multiple callouts in the queue. This del-ay 
keeps the modem from being ••hogged" when 
there are many callout requests that occur 
within a small period of time. The delay 
al 1 ows a remote user to 1 og in (if 
configured) . A delay of "Infinite" means 
calld will not start another callout until 
the "chcall -n*» command is run. A delay of 
"None** indicates that callouts will always be 
started immediately upon being enqueued. 
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The number of calls currently in the callout 
manager queue. 

The maximum length of the callout manager 
queue* If there are this number of callouts 
already in the queue, mkcall will retium an 
error if an attempt is made to enqueue 
another one. 

Shows the amount of time before the callout 
daemon will start another callout - 
"Immediate" means the next callout to be 
enqueued with mkcall will start immediately* 
"On demand" means that calld will not start 
another callout until the "chcall -n" command 
is run. 

The -O option is used by GMIS as a "command to 
discover" . 

This command is available from within the GMIS unit. 
The fastpath is "brc_callman" . 

Options 

-n # Show information eJdout the callout with the 
specified callout ID (#) 

-a Show callout record content 

-N Do not show headers 

. -c Show callout manager status information 

-O ' "Command to Discover" (used by GMIS) 

Example 

To show information about callout ID nximber 37 including 
the callout record contents: 

Iscall -n 37 -a 



Calls 
Max Calls 

Next Call 
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Files 

/var/call/calls/call .Ctrl A binary file which stores 

the callout manager queue and 
configuration parameters. 

Related Information : 

The following commands/programs: callcfg, call act, 

calif orce, netact, netactd, netcall, mkcall, rmcall, 
chcall, calld, callout, callbin. 



17. Islses Command 



Syntax : 

Islses 

Description 

If Session Logging is enabled (see confmon) , when a 
remote user calls in to a system a file is created which 
contains a log of all activities performed. There is one 
such log file for each time a remote service 
representative logs in to the system. These session 
files may be listed with the Islses command. The name of 
the log file represents the date and time at which the 
call*baclc occurred. For example: 

BRC-121892144357 

Indicates that a call-back occurred on December 18th 
1992 at 2:43:57 PM. 

This command is not available from within GHIS as an 
individual command, but is used by GHIS to build a list 
of logged sessions from which a session to review or 
delete may be picked. 

Related Information : 

The following commands/prograuns : confperm, doremote, 
confmon, callscript, showscript, showses, showlses, 
rmlses. 
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18. Ismsg command Program 



Syntax: 

5 

Ismsg [-n source_identif ier] [ (-i | -e I -a) ] [-d] 
[-0] t-N] t[-S] -I inessage_identif ier] 

Description 

10 

The Ismsg coBunand program is used to output the messages 
monitored by the RSF unit. There are several options 
provided for different output formats. If no options 
are provided, the default is to use -i for SYSTEM 
rs sources and -e for ASCII sources. 

Options 

-n source_identif ier Specifies the identifier of the 



20 source to be listed, 

-i List the ID^s only. 

-e List ID'S and expressions (only 

25 with ASCII sources) • 

-a List the following information: 

expression (ASCII sources only) , id, 
count, threshold, duration, and 
30 keepmax . 

-d In addition to what is displayed 

with -a, output the timestamp and 
full description of all messages 
35 with a coxint > 0. 

-o List only the over-threshold 

messages. 

^ -N Suppress the headers. 

-S List output in GMIS ready format. 

-I message_identif ier List only the message with given 
45 id- 
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Example 

To give a full listing of all messages that are over- 
threshold: 

5 

Ismsg -a -o 
Files 

10 Related Information: 

The following commands/progrsans : chrsf, chmsg, chmsrc, 
rsfd, Ismsrc, mkmsg, mkmsrc, rmmsg, rmmsrc, netact, 
netactd . 

75 

19. Isatsrc cosmand Prograj&s 



syntax: 

20 

Ismsrc [-iaArcpN] [-t type] t(-S] -n source_identif ier] 
Description 

25 The Ismsrc command is used to output the sources 
monitored by the RSF xinit. There are several options 
provided for different output formats. 

Options 

30 

-n source_identifier Specifies the identifier of the 



source to be listed. 

-i List source identifiers only. 

35 -a Full listing of source identifier, 

type, cleantime, searchtime, and 
overthreshold values. 

-A List source identifier, action, and 

40 action-blocked values. 

-r List record of actions. 

-c List record of actions on behalf of 

cluster nodes. 

-p List source identifier and path. 

-N Suppress headers. 

-t type List only sources of given type. 
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can be ASCII or SYSTEM. 
-S List output in GMIS ready format. 

Example 

To give a full listing of all ASCII sources: 
Ismsrc -a -t ASCII 
Related Information : 

The following commands/programs: chrsf, chmsg, chmsrc, 
rsfd, Ismsg, mJcmsg, mkmsrc, rmmsg, rmmsrc, netact, 
netactd* 



20. aailact R87 Action Program 



Syntax 

mailact source_identif ier description_f ile 
message_identif ier 

Description 

Mailact is an R5F action (i.e., it may be configured as 
an action that is taiken by RSF when an over- threshold 
condition occurs) . The mailact action sends E-mail to 
an address specified with the callcfg command. 

To use this action, RSF is configured as though it were 
to use a local modem to make callouts. Telephone 
numliers for the response center and other modem related 
parauneters are ignored if this action is used. Only £- 
mail is sent. 

If the E-mail address specified is the address of a user 
on a remote machine, be user to configure sendmail 
appropriately . 

The callout record that is sent via E-mail is created by 
callact and includes the following items: 

Subject line with originating system and shozrt 

description 

Current date and time 

The text of the over threshold message: 
"description_f ile " 

This utility is not used from the command line or from 
GMIS. It is meant to be invoked by rsfd as an action. 
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Options 

source^identif ier Which monitored source is involved 

with this action. 

description_f ile File containing text of over-threshold 

message* 

message_identif ier ID of the message that is over- 
threshold. 

Related Information: 

The following commands/programs: callcfg, calif orce, 
net act, netactd, netcall, mXcall, Iscall, rmcall, 
chcall, calld, callout, callbin. 



21. mXcal 1 Command 



Syntax : 

mkcall [-0 origin] [-d description] [-f file] 

[-p pcode] [-S scode] [-S site-information] 



Description 

The HSF callout manager controls the sequencing and 
timing of callouts to a response center* It manages a 
queue of callout requests. This queue may be viewed and 
manipulated using the Iscall and rmcall commands. The 
queue is serviced by a daemon process (calld) . 
Parameters relating to this queue may be viewed and set 
with the Iscall and chcall commands. 

The mkcall command queues a new callout request with the 
callout manager. The Information specified with the -f , 
*Pr "S, and -S options is queued along with the request 
and is eventually passed to the "callbin" command. See 
the "callbin" command for more information on these 
options. 

The -o argument is used to specify the origin of the 
callout (the hostname of the system that is the source 
of callout) . This is used to identify the calling 
system in the case of several clxister clients on a liAN. 
If this paraimeter is not supplied "Unknown" is used. See 
callact for more information on cluster callouts. 

The -d argument specifies a short description of the 
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reason for the callout:. This description is shown when 
Iscall is used to list queued callouts. If this 
parameter is not supplied "Unknown" is used. 

If -f is not supplied, mkcall will read from stdin. If 
-p or -s are not supplied, a default of 0x0000 is used. 

This cosnnand is not meant to be executed from the 
command line or from GMIS. It is called from the 
netcall and callact script programs. For callouts 
associated with the system error log the short 
description passed with -d is the "Error Description" 
field. 



Options 



-o origin Origin of callout (name of calling 

system) 

-d description Short description of the reason for 

the callout 

-f file File specifying content of callout 

record (see callbin) 

-p primary-code Hexadecimal Primary Error code (see 

callbin) 

-s secondary-code Hexadecimal Secondary Error Code 

(see callbin) 

-S "site_information" Site identifier (see callbin) 

Example 
Files 

/var/call/ calls/call. Ctrl A binary file which stores 

the callout manager queue and 
configuration parameters. 

Related Information: 

The following commands/programs: callcfg, callact, 
calif orce, netact, netactd, netcall, Iscall, rmcall, 
chcall, calld, callout, callbin. 

22. BkBsg Conmand 

Syntax: 
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vxksisq -n source_ident:if ier {{ expression | -i 

message^iden^if ier } [-t threshold] [-d duration] 
[-k keepmax]) | { -f initialization_f ile ) 

Description 

The mkmsg command adds a new message to be monitored by 
the RSF unit for the given source. The identifier of 
the source for which the message is monitored is a 
required option and either the -e, -i, or -f options 
must be used. The -e and -i options are used for making 
a single message and the -f option is used for batch 
message creation. 



Options 

-n source_identif ier 

-e expression 

-i message_identif ier 

-t threshold 

-d duration 

-k keepmax 

-f initialization^file 



Specifies the identifier of the 
source to be removed. 

Specifies the regular expression 
for the message (ASCII sources) . 

Specifies the message id (SYSTEM 
sources) • 

Specifies the threshold value for 
the message. 

Specifies the duration value for 
the message. 

Specifies the keepmax value for 
the message. 

Specifies the initialization file 
for batch message creation. The 
following is an exaunple of the 
format for both ASCII and SYSTEM 
sources : 



For an ASCII source: 



lexpression 
"system_error_. *' 



threshold 
2 



" i/ o__error_on_dev ice . * " 5 



duration 
1-day 
4 -days 



For a SYSTEM source: 



lid 

23e44f 
abcdef 



threshold 
2 

10 



duration 

1- day 

2 - hours 



keepmax 

50 

10 



keepmax 

50 

10 
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Defaults 

If the options are not provided, the default threshold 
is 5, duration is 1-day and keepmax is 20. 



To make a new message for the ASCII source ''testsource" : 
mkmsg -n testsource -e "controller number -t 10 

Related Information: 

The following commands/programs: chrsf, chmsg, chmsrc, 
rsfd, Ismsg, Ismsrc, mkmsrc, rmmsg, rmmsrc, netact, 
netactd. 



23* mkmsre Comaand 



Syntax : 

mkmsre -i source_identif ier -p path -a action 

t-t type] [-C cleantime] [-s searchtime] 
[-f initialization_file] 

Description 

The mkmsre command is used to define a new source to be 
monitored by the RSF unit. The source is a file located 
on the system which is either a system log file or an 
arbitrary ASCII log file generated by any application. 
The. mkmsre command requires a user defined identifier 
for the source, the path to the log file, and the path 
to the action to execute when an over-threshold 
condition occurs. 



Example 



Options 



-i source identifier 



Specifies the identifier of the 
source to be created. 



-p path 



Specifies the path to the source. 



•a action 



Specifies the path to the action 
to execute when an over- threshold 
condition occurs. 



-c cleantime 



-t type 



Specifies the type of the source 
(ASCII or SYSTEM) - 

Specifies the interval at which 
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the RSF database is cleaned < 



10 



*s searchtime 



Specifies the interval at which 
the RSF daemon scans the log for 
new messages* 



"f initialization^f ile Specifies an input file for 

initializing the messages 

associated with the new source* 
The following is an example of 
the format for both ASCII and 
SYSTEM sources: 



76 



#expression 

"system_error_. 

" i/o_error_on_device - 



For an ASCII source: 



threshold 
2 

*" 5 



duration 
1-day 
4 -days 



For a SYSTEM source: 



keepmax 

50 

10 



25 



#id 

23e44f 
abode f 

Defaults 



threshold 
2 

10 



duration 

1- day 

2 - hours 



keepmax 

50 

10 



30 



If the options are not provided, the default type 
ASCII, cleantime is 1-day and seektime is 5-hours* 
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Example 

To make a new source named ••testsource" of type ASCII: 

mJansrc -i test source -p patli_to_source -a path_to_action 
-t ASCII 

Related Information: 

The following commands/programs: chrsf, chmsg, chmsrc, 
rsfd, Ismsg, Ismsrc, inlcmsg, rmznsg, nmnsrc, netact, 
netactd- 

24 « netact command Program 

Syntax : 

netact hostname action source_identif ier 

description_f ile message^identif iaii [options] 

Description 

25 The netact command program contacts the netactd daemon 
on the server machine ''hostname*' and requests that 
"action" be run on that machine* The rest of the 
options are arguments to the remote action. The 
"description_f ile" is a local file which is temporarily 
transferred to the remote host. The standard and error 
output from the remote command is transferred back and 
written on standard output of netact program. Following 
"message_identif ier, " a list of additional options may 
be specified. These will be passed to the remote action 

The netactd daemon must be running on the remote host. 
This utility is not used from the command line or from 
GMIS. It is used in scripts like callact and call force • 

Options 

hostname The remote host to contact. 

action The pathname of the action on the 

45 remote host. 

source_ldentif ier Which monitored source is involved 

with this action. 

50 description_f ile File containing text of over-threshold 

message. 
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message^identif ier ID of the message that is over- 
threshold • 

[options] Optional list of options which will be 

passed to the remote action. 

Related Information: 

The following commands/programs: callcfg, callact, 
call force, netactd, netcall, mkcall, Iscall, nncall, 
chcall, calld, callout, callbin. 



25. netactd Cluster Daemon 



Syntax : 
Description 

The netactd daemon services requests from the netact 
command prograun running on remote hosts. It is 

implemented as an RPC server using the TCP/IP protocol. 
This daemon and the associated netact command are used 
to implement the callout cluster environment. 

The daemon is not run directly from the command line. It 
may be started and stopped from GHIS or from the command 
line with the chrsf command. The fast path for GMIS is 
"actions" . 

Rel a ted I n f orma t ion : 

The . following commands/progreons : chrsf, callcfg, 

callact, callforce, netact, netcall, mkcall, Iscall, 
rmcall, chcall, calld, callout, callbin. 



26. netcall RSF Action Program 



Syntax: 

netcall source_identif ier description_f ile 

message_identif ier host_name site_inf ormation 
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Description 

Netcall is an RSF action. It is used on a cluster server 
systexB in conjunction with the callact, netact, and 
netactd programs to send a callout record to a response 
center from a cluster client system response center in a 
clustered callout environment. 

When a cluster client needs to make a callout to the 
response center, callact is invoked by rsfd on the 
client system. Callact determines that it needs to send 
the callout record to the cluster server system, so 
callact invokes netact with an action of netcall. 
Netcall passes the callout record to the callout manager 
(see mkcall) . Netcall also handles remote callforce 
requests . 

The callout record that is sent to the response center 
is created by callact or callforce. Netcall adds 
cluster server site configuration to the callout record 
before passing it to the callout manager (for normal RSF 
callouts) or directly to callout (for forced callouts) • 
Netcall may be configured to send mail to a given E-Mail 
address whenever a remote callout request is made. 

This utility program is not used from the command line 
or from GMIS. It is meant to be invoked by netactd as 
an action on behalf of a remote callout request. 

Options 

source_identif ier Which monitored source is involved 

with this action. 

dfescription_f ile File containing callout record 

generated by callact. 

message_identif ier ID of the message that is over- 
threshold. 

host_name Network name of the host that is 

making this request, 

site^inf ormation Site identifier information from the 

cluster client. 

Related Information : 

The following commands/programs: callcfg, callact, 
callforce, netact, netactd, mkcall, Iscall, rmcall, 
chcall, calld, callout, callbin. 
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27 « rmcall CoBuaand 



Syntax: 

rmcall ID [ID ID . . . ] 



Description 

The RSF callout manager controls the sequencing and 
timing of callouts to a response center. It manages a 
queue of callout requests. Reqpiests are enqueued using 
the mkcall command. Requests and parameters are viewed 
with the Iscall command. The queue is serviced by a 
daemon process (calld) . Parameters relating to this 
queue may be set with the chcall commemd. This command 
removes the callouts requested with the specified 
request ID(s} . See the Iscall command for a definition 
of "request ID" . Callouts that have already been 
started ("S" status) may not be removed. 

This command is availaible from within GKES. The 
fastpath is "brc_callman" . 

Options 

ID Request ID of the callout request to be removed 

Example 

To remove callout request ID number 25 

rmcall 25 

Files 

/var/call/calls/ call. Ctrl A binary file which stores 

the callout manager queue and 
configuration parameters. 

Related Information: 

The following commands/progrsuns : callcfg, callact, 
call force, netact, netactd, netcall, mkcall, Iscall, 
chcall, calld, callout, callbin. 



28. raises Conmaxid 



Syntax: 
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rmlses logged-session 
D€Script:ion 

Removes the specified logged session. The list of 
currently logged sessions may be viewed using Islses. 

This command is availed^le from within GMIS* The 
fastpath is "call^mon". 

Options 

logged*session The logged session to remove 
Related Information: 

The following commands/programs: confperm, doremote, 
confmon, callscript, showscript, showses, Islses, 
showlses. 



29. rsmsg Command 



Syntax: 

rmmsg -n source_identif ier -i message_identlf ier 
Description 

The CTomsg command is used to remove a monitored message 
from a monitored source. This is used to alert the RSF 
unit to no longer monitor the given message. 

Options 

-n source_identif ier Specifies the identifier of the 

source for which the message 
belongs. 

-i message_identif ier Specifies the message id to be 

removed from the given source. 
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Example 

To alert RSF to no longer monitor message id FFFFFFFF 
for source "testsource" : 

rmmsg -n testsource -i FFFFFFFF 

Related Information: 

The following commands/programs: chrsf, chmsg, chmsrc, 
rsfd, Ismsg, Ismsrc, mkmsg, mlaasrc, rmmsrc, netact, 
netactd. 

30. mmsrc Command 

Syntax: 

rmmsrc -n source^identif ier 
Description 

The rmmsrc command is used to remove the specified 
source from the list of message sources monitored by the 
RSF unit. After this is done, the mkmsrc command is 
used to restart monitoring of the source. 

Options 

-n source_identif ier Specifies the identifier of the 

source to be removed. 

Example 

To remove a source neuned "testsource" : 
rmmsrc -n testsource 
Related Information: 

The following commands/programs: chrsf, chmsg, chmsrc, 
rsfd, Ismsg, Ismsrc, mJcmsg, mJcmsrc, rmmsg, netact, 
netactd. 
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31. rsfd Command Daemon 



Syntax : 

rsfd [ -t level [ -f trace_file ] ] 
Description 

This is the RSF daemon. It can be started with an 
optional trace level between 0-9 and also an optional 
tracing output file. The default is no tracing. 

When rsfd program is started it performs a sanity check 
on the RSF configuration (see rsfstat) . Any warnings or 
fatal errors are reported. If there are any fatal 
errors the daemon will not start. 

Options 

-t level level specifies the detail of tracing 

output . 

-f trace_file trace_file specifies an output file for 
tracing output. 

Related Information: 

The following commands/programs: chrsf, chmsg, chmsrc, 
Ismsg, Ismsrc, mJcmsg, mkmsrc, rmmsg, rmmsrc, netact, 
netactd . 



32. rsfstat Command Program 



Syntax: 
rsfstat [-V] 
Description 

The RSF unit includes up to three daemons: calld, 
netactd, and rsfd. This utility displays a table 
showing the status of each daemon. If the daemon is 
rxinning then the status is "up". In this case, also 
shown are, how long the daemon has been running and what 
its process ID is. If the daemon is not running then 
the status is "down". 

If a partial installation was performed then only the 
status of the installed daemons is shown. 
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The -V option performs a check of the RSF configuration 
and reports any fatal errors, or warnings. Note: you 
must be root or "remote" to use the -v option. 

Options 

-V Perform sanity check on RSF configuration. 

Defaults 

Examples 

Typical output from rsfstat looks like the following: 
Daemon Status 



rsfd up (7-days, pid=10895) 

calld do%m 
netactd down 

Related Information : 

The following commands/programs: chrsf, chcall, rsfd, 
netactd , cal Id . 

33. shovlses Command 



Syntax: 

showlses logged-session 
Description 

This command is used to view a session log created when 
a remote user logs in to th.e system. 



If Session Logging is enabled (see confmon) , when a 
remote user calls in to a system a file is created which 
contains a log of all activities performed. There is 
one such log file for each time a remote service 
representative logs in to the system. These session 
files may be listed with the Islses command. The name 
of the session log is passed to showlses. The name of 
the log file represents the date and time at which the 
45 call-back occurred. For example: 

BRC-121892144357 



Indicates that a call-back occurred on December 18th 
1992 at 2:43:57 PM. 
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While viewing a logged session the following keys may be 
useful: 

q Quits showlses 

p Pauses/ resumes viewing 

! Speeds up viewing 

space Slows down viewing 

This command is available from within GMIS. The 
fastpath is "call_mon". 

Options 

logged-session The name of the logged session to 
review. A list of logged sessions may be seen using 
Islses. 

Related Information: 

The following commands/programs: confperm, doremote, 
confmon, callscript, showscript, showses, Islses, 
raises . 



34. shovscrlpt Command Program 



Syntax : 

showscript {-s | -r) script-file 
showscript -c script-file -p pid 

Description 

This command program is used along with the callscript 
command program to support the console logging and 
playback feature of the RSF call-back environment. The 
command reads files created using the -s option of 
callscript. These files contain scripted sessions with 
timing information so that they can be played back like 
a movie* 

The terminal that session files are viewed on must be 
equivalent to the kind of terminal that they are 
recorded on. In order to help ensure this, session 
files created by callscript contain the $TERM that was 
in effect %^en the script was created. This is checked 
against the STERM that is in effect when showscript is 
run. If they don't match then a warning message is 
printed. 

Note: Many times terminal types that have different 
names may have definitions close enough to allow the 
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session files to be viewed (e.g. vtlOO and xtenn) . 

The two different syntax forms are used to support the 
two different ways that the RSF unit looks at session 
files. The first form (using -s) reviews a complete 
session file (see showlses) . When the end of the file 
is reached showscript terminates. The second form 
(using -c and -p) shows the contents of a session script 
that is still being created (i.e., callscript is still 
running) . When the end of the file is reached 
showscript will wait for more data to be added to the 
file (see showses) . The process with the pid specified 
with the -p option is sent a SIGKILL signal when the 'k' 
"hot key" is hit. 

There are special keys that can be used while viewing a 
session: 

q Quits showscript 

p Pauses/resumes viewing 

1 Speeds up viewing 

space Slows down viewing 

k Terminates process with pid (used only with - 

c and -p) 

Note: The 'k» key does not end the showscript session. 
Hit 'q* to stop viewing. 

RSF users do not invoke this command directly or through 
GMIS. This command is called from the showses and 
showlses scripts which are available through GMIS. 

Options 

-s script-file Plays back the specified script file 

-r script-file Strips timing information from the 

specified script file. The result is 
written to standard output 
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(like tail -f) • 

soecifies the process ID ^^J^^*^? * 
'P P"-^ ilSllLL is sent^f the -k* "hot-key" is 

hit. 

Examples 

TO view a previously recorded session, 
showscript -s script-file 

TO strip timing information from a recorded session 
Showscript -r script-file > output-file 

Related Information: 

showlscs, raises. 
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35. 



slioirs as Commaiid 



Syntax: 
showses 
Description 



monitoring " '^^i t' wi"*nS SSsa4e is aisplay.d on a 
llSni? SolaJ'^S'The !SSi1a.inislrator. warning 

message says . . - 

Remote maintenance session in progress 
Type • showses • to monxtor 

This =o™«nd -ay tj.en be used by ^e '^^-^JlSJicI 

to view everything that administrator 

Slir'S'e ^ey, "it^lill "«me*5iately log the remote 

user off the system. 
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If t:he remote maintenance representative has been 
working on the system for a while before this command is 
run, all of the activity prior to the execution of 
showses will be seen. It may take a while to catch up 
with the remote session. The * ! * key may be used to 
speed up viewing. Other special keys are: 

g Quits showses 

p Pauses/restu&es viewing 

space Slows down viewing (until caught up) 

This command is available from within GHIS. The 
fastpath is "call_mon". 

Related Information: 

The following commands/programs: confpemn, doremote, 
confmon^ callscript, showscript, showses, Islses, 
showlses , rmlses . 
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DEFIKITIOW8/GIXD88ARY OP TERMS 



SOURCE ATTRIBUTE DATABASE: 

A binary file managed by RSF xinit 10-10 which 
records information about sources being monitored 
by RSF unit 10-10 including parameters that control 
how each source should be monitored, 

MESSAGE TEMPLATES DATABASE: 

A binary file managed by unit 10-10 which contains 
search criteria and status information for each 
message being monitored. There is an individual 
message templates database for each source being 
monitored. 

STORED MESSAGE DATABASE: 

A binary file managed by unit 10-10 which contains 
a recent history of messages being monitored which 
have appeared. There is an individual stored 
message database for each source being monitored. 

KEEFMAZ: 

For each message in the message templates database, 
the keepmax parameter sets an upper limit on how 
many of this particular message will be backlogged 
in the stored message database. 

SOURCE : 

A "source" is any source of messages (such as a log 
file) . 

MESSAGE: 

A "message" is a record that appears in a source. 
THRESHOLD: 

A "threshold" is a number of times that a 
particular message must be observed before that 
message is considered "over-threshold. " 
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DURATION: 

A "duration" is the amount of time allowed in which 
a particular message "counts" toward the threshold. 
Together, the threshold and the duration define the 
over-threshold status of a message. A message is 
considered overthreshold if the threshold is 
reached within the duration (e.g. 4 must appear 
within 5 minutes to be over-threshold) • 

ACTION: 

An "action" is a program that is run in response to 
an overthreshold condition. Any program can be 
specified as an action. 

SEARCHTIME: 

For each source, this parameter controls how often 
unit 10-10 will scan the source for new messages. 

CLEANTIME: 

For each source, this parameter controls how often 
the associated stored message database is cleaned 
(old messages are removed) . 

STAKDAIiONE : 

A host system with modem connection. 

CLUSTER CLIENT: 

A host system with no modem connection which uses a 
cluster server system to make callouts. 

CLUSTER SERVER SYSTEM: 

A host system with modem connection which is shared 
with cluster client systems. 
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^ flunngp TV My 10-3."4 T.TBRARY 

1. Action Routines 

Routines uysed to maintain the log of actions taken 
by the RSF unit. 

Remove (delete) the action log 
Add an entry to the action log 

2. control Routines 

Routines used to access the source attributes 
database (control file) . 

Ocen the control file 

Riad the next sequential record from the 

SSSfreal^ pointer to the start of the control 

Idd^a new record to the end of the control 

up a control file record based on the 

Sange tSe contents of a specific control file 

SlHte a specific record from the control file 
30 Close the control file 

3. config Routines 

Routines used to access the callout configuration 
(call.conf file). 

set default callout configuration ^^^^^^""^^^ 
Read the callout configuration from the 

SJlt;"°"thl^^"callout configuration to the 

call.conf file 
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Display Msg, Routines 

Routines used to format messages that have been 
received by the RSF unit. 

Generic routine to print format a message 
regardless of type 

Routine to print format an ASCII message 
Routine to print format a system message 

Keep File Routines 

Routines used to access the stored message database 
(*.keep files) 

Delete an entire keep file 
Create a new keep file 

Clean a keep file (removing logically deleted 
entries) 

Open a keep file 

Read the next sequential entry from the keep 
file 

Move read pointer to the start of the keep 
file 

Add a new entry to the end of the keep file 
Logically delete the last N kept messages with 
a specific ID 

Logically all kept messages with a specific ID 
Adjust durations for kept messages with a 
specific ID 

Logically delete expired messages with a 

specific ID 

Cloase the keep file 

Support Routines 

Miscellansous routines used by various RSF modules. 

Internal/User parameter format conversion 
routines • 

User parameter format checking routines 
Initialization file parsing routines 
User access restriction routines 
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Error Msg. Routines 

Routines used to access the Host System Error Ix>g 
file. 

Read the next sec[uential record from the host 
error log file 

Find the start of the next sequential record 
Format a system error log file record into 
human readable form 

Search Routines 

Routines used to access the message template 
database search files). 

Delete an entire search file 
Create a new search file 
Determine if a search file is empty 
Open a search file 

Generic routine to search for a matching 
search file entry 

Search for a matching ASCII record (use 
regular expressions) 

Search for a matching system record (use 
message ID) 

Read the next sequential record from the 
search file 

Move read pointer to the start of the search 
file 

Generic routine to add an entry to a search 
file 

Add an ASCII search record to the end of a 
search file 

Add a system search record to the end of a 
search file 

Add a new record to the end of the search file 
Sort all the records if the search file by 
message ID 

Look up a record in the search file based on 
message ID 

Change the contents of a specific search file 
record 

Delete a specific record from a search file 
Close a search file 
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9. Source Routines 

Routines used to access RSF sources (log files) . 
Open a source 

Generic routine to read the next sequential 
record from source 

Read the next sequential record from an ASCII 
source 

Read the next: sequential record from a system 
source 

Close a source 
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10. Verify Routines 

Rout:ines used to check to RSF configuration files 
for errors. 

Routine to check the validity of a host name 
Routine to check the validity of a tty 
Routine to check the validity of remote's 
pxiblished password 

Routine to check the callout configuration 
Routine to check the source attributes 
dateibase 

Routine to check daemon status 
Routine to check free space on disks 
Verify a specified subset of the above 

11* Config. Diag. Routines 

Routines used to configure the diagnostic callout 
parameters • 

Routine to dissible diagnostic callout 
Routine to enable diagnostic callout 
Routine to read diagnostic frequency 
^ Routine to write diagnostic frequency 

12. PXD Routines 
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Routines used to manage daemon PID files (*.pid 
files) . 

Create a PID file containing PID of caller 

Remove a PID file 

Check the status of a PID file 

Send a signal to a daemon (uses PID file to 
get PID) 
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SBCTIOK IV 

#1 - EXAMPLES OF STANDALOKB CXLLOUT RECORDS 

Parameters required tor logging baclc into best aystea 
are in bold type. 

Date: Fri Apr 2 10:23:11 EST 1993 
Site Configuration 



calltype: modem 
suptype: RCS2 
sysid: UD9999 

remote phone numbers: 
18005552855 

oppbone: (665) 555-3423 
opname: Jonathan S. 
mail: root 
syaphone : 6655552331 
paasvd: phoenix 
tty: /dev/ttyO 

Terminal type that must be used for callbaelc: vtlOO 
Full Text of Message 



ERROR LABEL: SEM^ERRl 
ERROR ID: BAECC981 

Date/Time: Fri Apr 2 10:23:08 

Sequence Number: 397433 

Machine Id: 0O0OO4375C3A 

Node Id: hazel 

Error Class: H 

Error Type: PERM 

Resource Name: serdasdaO 

Error Description 
MICROCODE PROGRAM ERROR 

Probable Causes 

STORAGE CONTROLLER MICROCODE 

Install Causes 

MISMATCH BETWEEN HARDWARE AND MICROCODE 
MISMATCH BETWEEN SOFTWARE AND MICROCODE 

Recommended Actions 



82 



EP 0 632 382 A1 



CHECK FOR CORRECT MICROCODE FIX 
Failure Causes 

LOADABLE STORAGE CONTROLLER MICROCODE 
Recommended Actions 

PERFORM PROBLEM DETERMINATION PROCEDURES 

Detail Data 
SENSE DATA 

OlFF 0000 0000 0000 0000 0000 0000 0000 
System Information 



OS Name: BOSX 
OS Version: 3 
OS Release: 2 

Configuration Information 



INSTALLED RESOURCE LIST WITH VPD 

The following resources are installed on your machine. 

sysplanaro 00-00 CPU Planar 

Part Number 043G1797 

EC Level 00C74316 

Processor Identification. . • •00000594 

ROS Level and ID IPLVERl.O 

LVLl . 02 , 043G2189 

Processor Component ID 0102006300000014 

Device Specific- (ZO) 012048 

Device Specif ic. (Zl) 021047 

Device Specific. (Z2) 031246 

Device Specific. {Z3) 041149 

Device Specific. (Z4) CD234D 

Device Specif ic. (Z5) ED234D 

Device Specific. (Z6) 0A114A 

Device Specific- (Z7) 2A114A 

Device Specific. (Z8) 4A114A 

Device Specific. (Z9) 6A114A 

ROS Level and ID OCS (07040A00) 

ROS Level and ID SEEDS (FOBABCOl) 



ioplanarO 00-00 I/O Planar 

EC Level 39 

busO 00-00 MicroChannel Bus 

sioo 00-00 Standard I/O Planar 
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Part Number 52G1265 

EC Level D25842 

Serial Hxunber 00O00299 

FRU Number 52G1266 

Manufacturer IBH97N 

Displayable Message STANDARD I/O 

Device Driver Level 00 

Diagnostic Level 00 

ROS Level and ID 0000 

Displayeible Message STANDARD SCSI 

Device Driver Level 00 

Diagnostic Level 00 

Loadable Microcode Level. . . .004 4 

ROS Level and ID 0044 

Read/Write Register Ptr 0100 

fdaO 00-00-OD Standard I/O 

Diskette Adapter 
fdO 00-00-OD-OO Diskette Drive 

ppaO 00-00-OP Standard I/O 

Parallel Port 
Adapter 

Ipo OO-OO-OP-OO Bull Compuprint 4/51 

scsiO 00-00-OS Standard SCSI I/O 

Controller 

hdiskO 00-00-OS-OO 1,37 GB SCSI Disk 

Drive 

Device Specif ic. (ZO) 0000 

Manufacturer IBM 

Machine Type and Model ST41600N 

Serial Number 00055744 

Device Specif ic. (Zl) 70899604 

cdO 00-00-OS-lO CD-ROM Drive 

Device Specific. (ZO) 0580 

Manufacturer TOSHIBA 

Machine Type and Model .CD-ROM DRIVE :XM 

ROS Level and ID 3232 

hdiskl OO-OO-OS-20 1,37 GB SCSI Disk Drive 

Device Specific. (ZO) 0000 

Manufacturer IBM 

Machine Type and Model ST41600N 

Serial Number 00073612 

Device Specif ic. (Zl) 70899604 

rmto oo-OO-OS-50 2.3 gb 8mm Tape Drive 

Device Specif ic. (ZO) 0180 
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Manufacturer EXABYTE 

Machine Type and Model EXB-8200 

saO 00-00-Sl Standard I/O 

Serial Port 1 

ttyO 00-00-sl-oo Asynchronous 

Terminal 

sal 00-00-32 Standard I/O 

Serial Port 2 

ttyl 00-00-S2-00 Asynchronous 

Terminal 

scsil 00-01 SCSI I/O 

Controller 

Device Driver Level OO 

Diagnostic JLevel oo 

Displayable Message SCSI 

EC Level C74317 

FRU Number 31G9729 

Manufacturer IBM97N 

Part Number 43G1811 

Serial Number 

Loadable Microcode Level « . . .0044 

ROS Level and ID 0050 

Read/Write Register Ptr.....0100 

hdisk2 00-01-00-00 1.37 GB SCSI Disk Drive 

Device Specific. (20) 0000 

Manufacturer ibm 

Machine Type and Model ST41600N 

Serial Number 00073493 

Device Specific. (Zl) 70899604 

ento 00-03 Ethernet High- 

Performance LAN 
Adapter 

Network Address 02608C2F9E82 

ROS Level and ID 0015 

Displayable Message 802 . 3/ETHERNET 

Part Number 000G3369 

EC Level C73859 

Device Driver Level oi 

Diagnostic Level oi 

FRU Number O00G3368 

Serial Niimber 00110116 

Manufacturer 204491 

X25S0 00-04 X.25 Adapter 

fddiO 00-05 FDDI Primary Card, 

Single Ring Fiber 
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^„ 10005AB8054F 

Network Address. ..• j^^^q g 

Displayable Message [civile 

EC Level 81F9003 

FRU Number VEN0857049 

Manuf actiirer ^ 3^3 

Part Number '.001114 

serial ^^tl' 'rk"" *. * * 0000 
ROS Lrevel and id. • 
loadable Microcode Level.... 01 

FDDI Primary card, 
fddil °0 °^ Dual Ring Fiber 

10005AB8054E 

Network. Address...- ring B 

Displayable Message :c73876 

EC Level 81F9003 

FRU Number .VEN0857049 

Manufacturer " 33^59393 

Part Number 001069 

serial Number... *. *. . OOOO 

ROS Level and ID. 

Loadable Microcode Level..-. 01 

FDDI Extender Card 
fddixo OJ-J^ 16-Port Asynchronous 

sa2 0°-°^ Adapter EIA-422A 

I6PORT RS422 

Displayable Message :c26396 

EC Level .030F9297 

FRU Number ven0857049 

Manufacturer 071F0976 

part Number 001329 

serial Number " 

00-08-01-00 Asynchronous 
tty2 Terminal 

00-00 Floating Point 

fpaO processor 

nn-00 serial Optxcal 

slco Link Chip . 

loplanarl 00-10 VO PXanar 

FFFFFFFF 

EC Level 

MicroChannel Bus 

busl ^S'^? serial-Link Disk 

serdasdaO ou-aj. Adapter 

04 5G2774 

Part Niomber 00009908 

Serial Nxmber '.0015720938 

EC Level . • . - 
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Manufacturer trmac;-* 

ROS Level and ID. , . ! ! ! ! ! ! ! i ! 

Loadable Microcode Level 00 

Devace Driver Level oi 

Displayable Message. I SERIAL-ADAPTER 



Serial -Link Disk 
Controller 



serdasdcl 00-11-02 

Part Number A^rQs^R 

ilattiJ^^'--:, :::Sooo3?38 

ROS Level and ID. . . .* .* .* .* ; :™ 

^^^^^^ 00-11-02-01 857MB F Serial- 

Link Disk Drive 

S'^^v^*'' 95X2431 

EC Level C79493 

Sf^i*^ *^i?^er .B182136E 

Machxne Type and Model 9333-100 

Manufacturer tbm -non-> 

ROS Level and ID. . . , „ 

Device Specific. (Zl) 9103944 

Device Specific. (Z2) 7102 

Device Specific. (23) 70F9042 

Device specific. (Z4) 92087 

^'^^^^'^ 00-H-O2-03 857MB F Serial- 

Link Disk Drive 

E^'^eJ^*'' 95X2431 

S^hfi ^^^"^ B207056L 

Machine Type and Model 9333-ioo 

Manufacturer tbm non^ 

ROS Level and ID. .... . . I . sf* 

Device specific. (Zl) . 9104086 

Device specific. (Z2) 5866 

Device Specific. (Z3) 70F9042 

Device Specific. (Z4) 92093 



serdasdco OO-11-03 



Serial-Link Disk 
Controller 



• • 00002893 

Machine Type and Model 9333-000 

Manufacturer tbm nn«-i 

ROS Level and ID...::.:::::;™ 

00-11-03-00 1.07GB F Serial- 
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Link Disk Drive 

69F9821 

Part. Number C79493 

EC Level. .R012573V 

serial Number.. • 9333-110 

Machine Type and Model _QgQ2 

Manufacturer. . . • 

ROS Level ID...- • 8203386 

Device Specific. (Zl) .. • ^^^^^ 

Device specific. (22) ... - 70F9042 

Device specific. (")•.• .92199 

Device specific. {Z4) ^ 

Ethernet High- 
entl Performance IAN 

Adapter 

. . 02608C2F8A70 

Network Address ^^^^ 

ROS Level and id 802.3/ETHEBNET 

Displayable Message '/.0O0G3369 

Part Number *. '. ..C73859 

EC Level oi 

Bevice Driver Level ox 

Diagnostic Level .0O0G3368 

rRU Number ^ .0O114965 

serial Number .204491 

Manufacturer 

4-Port Multi- 
opqao 00-15 protocol ^ 

Commtinications 
controller 
no-15-oo Multiprotocol 
fflpqo 00-15-00 Adapter port 

on 15-01 Multiprotocol 
Bpql 00-15-01 Adapter Port 

on 15-02 Multiprotocol 

apq2 00-15-02 Adapter Port 

«o 15-03 Multiprotocol 
mpq3 00-15-03 Adapter Port 

OO-OB 

memo 

Device specific. (23) • -07 

EC Level. qq 

Device specific. (ZO .... • o^ 

Device Specific. (|1) qo 

Device Specific. (Z2) 

Si2e 

64 MB Memory Card 

00-OC 

meml 

Device Specific. (Z3) . . . . • • • -O^ 
EC Level 
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Device Specific. (ZO) qo 

Device Specific. (Zl 'SS 

Device specific. (Z2) .WSS 

64 

o4 MB Memory Card 

ErilJeff"!^""*^"^ 

Device specific. (z8)' .* .* .* ["^q 
Device specific. (Zl) * qo 

stli""^ sp«^ific.(Z2) :.oS 

64 

64 MB Memory Card 

Eriijefffftf' ^- 

Device specific.* (20) .* .* .* .' .* '."Iq 
Device specific. (zi ' qo 

specific. (Z2) ::oS 

64 

o4 MB Memory Card 

Srilve?f?!fff?:^"> 

Device Specific .* (ZO) .* .* .* .* .' .* * ©J 

Device specific. (Zl) oo 

Device Specific. (Z2) [[qo 

64 

64 MB Memory Card 

2?"i^Jef!!!f^f"-^"> 

Device Specific* (20) .* .* .* .* " 'on 
Device Specific. (Zl) . . . . . ] qq 

Device Specific. (22) [[[oo 

^ 64 

sysunito qo-oo „ 

Bull DPX/20 System 
Unit 
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ara in bol* tyP«« 

Cluster Server_Conf iguration 

calltype: modem 

remote phone numbers : 
18005552855 

oppnone: 555-3423 
opnaao: Jonathan S. 

mail* root 

syiiione: 6655552331 

oa«: rrl Apr 2 09 = 40:00 EST 1«3 
Site configuration 

Cluster Mode Mamot fiver 

calltype: network 
suptype: RCS2 

opnaae: Jonathan S- 
mail: root 
o as svd * bennu 

Full Text of_Message 

ERROR IABEL: |i8E984F 

ERROR id: APr 2 09:39:55 

Date/Time: l^Uoll 

sequence Number: 1J88031^^^^^ 

Machine Id. 
Node Id: ^* 
Error Class: s 
Error Type: 
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Resource Name: SRC 

Error Descrip'tion 
SOFTWARE PROGRAM ERROR 

Probable Causes 
APPLICATION PROGRAM 

Failure Causes 
SOFTWARE PROGRAM 

Recommended Act: ions 

PERFORM PROBLEM RECOVERY PROCEDURES 

Detail Data 
SYMPTOM CODE 
256 

SOFTWARE ERROR CODE 

-9035 
ERROR CODE 

0 

DETECTING MODULE 
•srchevn.c'€line: »162* 
FAILING MODULE 
infod 

System Information 



OS Name: BOSX 
OS Version: 3 
OS Release: 2 

Configuration Information 



INSTALLED RESOURCE LIST WITH VPD 

The following resources are installed on your machine. 



sysplanarO 00-00 CPU Plemar 

Part Number 043G1797 

EC Level 00C74316 

Processor Identification* • • .00000594 

ROS Level and ID IPLVERl.O 

LVLl .02,04362 189 

Processor Component ID 0102006300000014 

Device Specif ic. (ZO) 012048 

Device Specif ic. (Zl) 021047 

Device Specif ic. (Z2) 031246 

Device Specific. (Z3) 041149 

Device Specific. (Z4) CD234D 
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Device Specific. (25) ED234D 

Device Specific* (26) 0A114A 

Device Specific. (27) 2A114A 

Device specif ic. (28) 4A114A 

Device Specific. (29) 6A114A 

ROS Level and ID OCS (07040A00) 

ROS Level and ID SEEDS (FOBABCOl) 

ioplanarO 00-00 I/O Planar 

EC Level 39 

busO 00-00 MicroChannel Bus 

sioO 00-00 Standard I/O Planar 

Part: Number 52G1265 

EC Level D25842 

Serial Number 00000299 

FRU Number 52G1266 

Manufacturer IBM97N 

Displayable Message STANDARD I/O 

Device Driver Level 00 

Diagnostic Level 00 

ROS Level and ID 0000 

Displayable Message.. STANDARD SCSI 

Device Driver Level 00 

Diagnostic Level 00 

Loadad>le Microcode Level. . . .0044 

ROS Level and ID 0044 

Read/Write Register Ptr 0100 

fdaO 00-00-OD Standard I/O Diskette Adapter 

fdO OO-OO-OD-00 Diskette Drive 

ppaO 00-OO-OP Standard I/O Parallel Port 

Adapter 

IpO OO-OO-OP-OO Bull compuprint 4/51 

scsio OO-OO-OS Standard SCSI I/O Controller 

hdiskO OO-OO-OS-OO 1.37 GB SCSI Disk Drive 

Device Specific. (20) 0000 

Manufacturer IBM 

Machine Type and Model ST41600N 

Serial Number 00055744 

Device Specific. (21) 70899604 

cdO 00-00-OS-lO CD-ROM Drive 

Device Specific. (20) 0580 

Manufacturer TOSHIBA 

Machine Type and Model CD-ROM DRIVE :XM 

ROS Level and ID 3232 

hdiskl OO-OO-OS-20 1.37 GB SCSI Disk Drive 



92 



EP 0 632 382 A1 



Device Specific. (ZO) 0000 

Manufacturer IBM 

Machine Type and Model ST41600N 

Serial Ntunber 00073612 

Device Specific. (21) 70899604 

rmtO OO-OO-OS-50 2.3 GB 8im Tape Drive 

Device Specific. (ZO) 0180 

Manuf act:urer EXABYTE 

Machine Type and Model EXB-8200 

saO 00-00-Sl Standard I/O Serial Port 1 

ttyO 00-00-Sl-OO Asynchronous Terminal 

sal 00-00-S2 Standard I/O Serial Port 2 

ttyl 00-00-S2-00 Asynchronous Terminal 

scsil 00-01 SCSI I/O Controller 



Device Driver Level 00 

Diagnostic Level 00 

Displayable Message SCSI 

EC Level C74317 

FRU Number 31G9729 

Manufacturer IBM97N 

Part Number 43G1811 

Serial Nximber 

Loadad^le Microcode Level. • « .0044 

ROS Level and ID 0050 

Read/Write Register Ptr 0100 

hdisk2 00-01-00-00 1.37 GB SCSI Disk Drive 



Device Specific. (ZO) 0000 

Manufacturer IBM 

Machine Type and Model ST41600N 

Serial Number 00073493 

Device Specific. (Zl) 70899604 

en to 00-03 Ethernet High- 

Performance LAN 
Adapter 

Network Address 02608C2F9E82 

ROS Level and ID 0015 

Displayable Message 802.3/ETHERNET 

Part Nximber 0OOG3369 

EC Level C73859 

Device Driver Level 01 

Diagnostic Level 01 

FRU Number 000G3368 

Serial Number 00110116 

Manufacturer 204491 
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x25s0 00-04 X.25 Adapter 

fddiO 00-05 FDDI Primary Card, 

Single Ring Fiber 

Network Address 10005AB8054F 

Displayable Message FDDI RING B 

EC Level C73876 

FRU Number 81F9003 

Manufacturer VEN08 57 04 9 

Part Number 31G9393 

Serial Nximber 001114 

ROS Level and ID 0000 

Loadable Microcode Level • « • . 01 

fddil 00-07 FDDI Primary Card, 

Dual Ring Fiber 

Network Address 10005AB8054E 

Displayable Message FDDI RING B 

EC Level C73876 

FRU Number 81F90O3 

Manufacturer VENO 857049 

Part Number 31G9393 

Serial Number 001069 

ROS Level and ID 0000 

Loadable Microcode Level • • • * 01 

fddixO 00-06 FDDI Extender Card 

sa2 00-08 16-Port Asynchronous 

Adapter EIA-422A 

Displayable Message 16PORT RS422 

EC Level C26396 

FRU Number 030F9297 

Manufacturer venO 857049 

Part Number 071F0976 

Serial NumJDer 001329 

tty2 00-08-01-00 Asynchronous Terminal 

fpaO 00-00 Floating Point Processor 

slcO 00-00 Serial Optical Link Chip 

slcl 00-00 Serial Optical Link Chip 

ioplanarl 00-10 I/O Planar 

EC Level FFFFFFFF 

busl 00-10 MicroChannel Bus 

serdasdaO 00-11 Serial-Link Disk 

Adapter 

Part Number 045G2774 

Serial Number 00009908 
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EC Level 0015720938 

Manufacturer XBH053 

ROS Level and ID OOOD 

Loadable Microcode Level* •••00 

Device Driver Level 01 

Displayable Message SERIAL- ADAPTER 

serdasdcl 00-11-02 Serial-Link Disk 

Controller 

Part Number 4 2G9 575 

Serial Number 00003738 

Machine Type and Model 93 3 3-000 

Manufacturer IBM -0053 

ROS Level and ID OC 

hdiske 00-11-02-01 857MB F Serial- 

Link Disk Drive 

Part Nximber 95X2431 

EC Level C79493 

Serial Nxamber B182136E 

Machine Type and Model 9333-100 

Manufacturer IBM -0902 

ROS Level and ID 63 

Device Specif ic. (Zl) 9103944 

Device Specific. (Z2) 7102 

Device Specif ic. (Z3) 70F9042 

Device Specif ic. (Z4) 92087 

hdisk7 00-11-02-03 857MB F Serial- 

Link Disk Drive 

Part Number 95X2431 

EC Level C79493 

Serial Number B207056L 

Machine Type and Model 9333-100 

Manufacturer IBM -0902 

ROS Level and ID 52 

Device Specif ic. (Zl) 9104086 

Device Specif ic. (Z2) 5866 

Device Specific. (Z3) 70F9042 

Device Specific. (Z4) 92093 

serdasdcO 00-11-03 Serial-Link Disk 

Controller 

Part Number 07G5194 

Serial Number 00002893 

Machine Type and Model 9333-000 

Manufacturer IBM -0053 

ROS Level and ID OB 
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hdis3c4 



00-11-03-00 



1.07GB F Serial- 
Link Disk Drive 



entl 



Part Number 69F9821 

EC Level C79493 

Serial Number R012573V 

Machine Type and Model 9333-110 

Manufacturer IBM -0902 

ROS Level and ID 63 

Device Specific. (21) 8203386 

Device Specific. (22) 10959 

Device Specific- (23) 70F9042 

Device Specific. (24) 92199 

00-14 Ethernet High- 

Perfomance LAN 
Adapter 

Network Address 02608C2F8A70 

ROS Level and ID 0015 

Displayable Message 8 02. 3/ETHERNET 

Part Number 000G3369 

EC Level C73859 

Device Driver Level 01 

Diagnostic Level 01 

FRU Nximber 000G3368 

Serial Number 00114965 

Manufacturer 204491 



mpqaO 

mpqO 
mpql 
mpq2 
mpq3 
memo 



meml 



00-15 

00-15-00 
00-15-01 
00-15-02 
00-15-03 
00-OB 



4 -Port Multi- 
protocol 
Commiinications 
Controller 
Multiprotocol 
Adapter Port 
Multiprotocol 
Adapter Port 
Multiprotocol 
Adapter Port 
Multiprotocol 
Adapter Port 
64 MB Memory Card 



Device Specific. (23) 07 

EC Level 21 

Device Specific. (20) 00 

Device Specific. (21) 00 

Device Specific. (22) 00 

Size .••..64 

00-OC 64 MB Memory Card 

Device Specific. (23) 07 
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EC Level 21 

Device Specific. (ZO) 00 

Device Specific. (21) 00 

Device Specif ic .( 22 ) 00 

Size 64 

xBeni2 00-OD 64 MB Memory Card 

Device Specific. (23) 07 

EC Level 21 

Device Specific. (ZD) 00 

Device Specif ic. (Zl) 00 

Device Specif ic. (Z2) 00 

Size 64 

mem3 00-OF 64 MB Memory Card 

Device Specific. (Z3) 07 

EC Level 21 

Device Specific. (ZO) 00 

Device Specific. (Zl) 00 

Device Specif ic. (Z2) 00 

Size 64 

iaem4 00- OG 64 MB Memory Card 

Device Specific. (Z3) 07 

EC Level 21 

Device Specif ic. (ZO) 00 

Device Specific. (Zl) 00 

Device Specific. (Z2) 00 

Size 64 

memS 00- OH 64 MB Memory Card 

Device Specific. (Z3) 07 

EC Level 21 

Device Specific. (ZO) 00 

Device Specific. (Zl) 00 

Device Specif ic. (Z2) 00 

Size 64 



sysunito 



00-00 



Bull DPX/20 system 
Unit 
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SECTION IV - Cont'd, 

«3 - EXAMPLE OP E-MAIL FOR A CALIOUT 

Successful callout: to response center: Mon Mar 15 
14:57:19 EST 1993 

The reason for the callout is as follows: 

ERROR LABEL: LION_BUFFERO 
ERROR ID: 50CA5315 



Date/Time: 
Sequence Number: 
Machine Id: 
Node Id: 
Error Class: 
Error Type: 
Resource Name: 



Thu Mar 11 14:15:08 
95740 

000006706300 

onion 

S 

TEMP 
tty3/0 



Error Description 

Buffer overrun: 64 port concentrator 
Failure Causes 

EXCESSIVE LOAD ON PROCESSOR 



Recommended Actions 

Reduce system load 

Reduce serial port baud rate 



Notes: 

If an E-mail address is configured^ E-mail such as the 
above exeunple will be sent to the specified address 
whenever a callout occurs. 

If it is desired to send E-mail notification to several 
people at once, then an E-mail alias is used. 



It will be apparent to those skilled in the art that many changes may be made to the preferred 
embodiment of the present invention. For example, while a UNIX based host computer system was shown 
as utilizing the present invention to provide remote support, the present invention may be used on other 
system platforms, in conjunction with other types of operating systems and graphical interfaces and other 
system configurations. Also, the invention may be used to monitor other types of host system sources. 

While in accordance with the provisions and statutes there has been illustrated and described the best 
form of the invention, certain changes may be made without departing from the spirit of the invention as set 
forth in the appended claims and that in some cases, certain features of the invention may be used to 
advantage without a corresponding use of other features. 

Claims 

1. A method of organizing and operating a proactive and reactive remote services facility <RSF) unit 
installable within a host system which is operatively connected to communicate with a remote response 
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center dedicated to performing remote support services for said host system involving diagnosis of host 
system problems reported to said center, said method comprising the steps of; 

(a) constructing a number of independently operable software components, each component being 
constructed for performing one of a predetermined number of different basic functions required for 

5 performing said proactive and reactive support for said host system; 

(b) including in each of said components, configuration control means for preconfiguring each 
component by establishing predetermined parameters defining how said each component is to 
perform said one of said number of basic functions in carrying out remote support; and. 

(c) integrating said number of software components together in a predetermined manner so that said 
10 components collectively perform said proactive and reactive remote support according to said 

predetermined parameters preconfigured in step (b). 

2. The method of claim 1 wherein said host system includes a host computer, an UNIX based operating 
system for controlling the operation of said host computer, a generic menu interface system (GMIS) 
75 unit for communicating with said operating system using menu initiated dialog sequences and a display 

terminal unit operatively coupled to said host computer and to said Gf^lS unit for enabling a user to 
enter commands directly or through said GMIS unit for execution by said RSF unit, said method further 
comprising the steps of: 

(d) operatively coupling each of said number of software components to said GMIS unit; and, 

20 (e) including within each of said number of components, a number of modules which operatively 

couple to said GMIS unit, said number of modules t>eing responsive to a different predetermined 
command set containing a small number of commands customized for configuring said each of said 
components according to step (b). 

25 3. The method of claim 2 wherein said computer system includes a number of source error log files used 
by said host computer for logging errors encountered while running applications on said host computer 
and wherein said remotely located response center performs support services for said host system by 
calling back into said host system in response to a first component of said number of components 
having detected an overthreshold condition which caused a caMout action to be made by said RSF unit 

30 for further diagnosis and correction of a system problem reported by said host system, said first 
component including said number of source error log files and a control attribute file and wherein said 
step (b) of said method further includes the steps of: 

(f) configuring each of said number of source error log files to be monitored by causing storage of a 
source record entry in said control file for each of said number of source log files to be monitored, 

35 said record entry containing a unique user specified name for said log file, a path name to said log 

file, information identifying the type of log file, information identifying how often to scan for new 
messages and information designating what notification action to invoke if a message is detected by 
said first component as being overthreshold; and; 

(g) initiating said notification action specified by said source record entry to said response center 
40 upon detecting an occurrence of an overthreshold condition within said source. 

4. The method of claim 1 wherein said number of components of said RSF unit are included within a 
predetermined number of subpackages, said predetermined number of subpackages including a 
problem detection and reaction subpackage. a system action subpackage. a callback subpackage and a 

45 cluster subpackage and wherein said method further includes the step of: 

selectively loading predetermined ones of said predetermined number of subpackages as a 
function of how said host system has been configured to operate. 

5. The method of claim 2 wherein said GMIS unit utilizes a hierarchical organization of menu screens; said 
50 organization including an initial problem determination submenu containing a number of selection items 

relating to specific components of said number of components, each selection item leading to a 
number of submenus which in turn lead to dialogs for each command of said small number of 
commands enabling configuration of said number of said components. 

55 6. A proactive and reactive remote services facility (RSF) unit installable within a host system which is 
operatively connected to communicate with a remote response center dedicated to performing remote 
support services for said host system involving diagnosis of host system problems reported to said 
center, said RSF unit comprising: 
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a number of independently operable software connponents. each component being constructed for 
performing one of a predetermined number of different basic functions required for performing said 
proactive and reactive support for said host system; 

each of said components including configuration control means for preconfigurlng said each 
component by establishing predetermined parameters defining how said each component is to perform 
said one of said number of basic functions in carrying out remote support; and, 

means for integrating said number of software components together in a predetermined manner so 
that said components collectively perform said proactive and reactive remote support according to said 
predetermined parameters. 

The RSF unit of claim 6 wherein said host system includes a host computer, an UNIX based operating 
system for controlling the operation of said host computer, a generic menu interface system (GMIS) 
unit for communicating with said operating system using menu initiated dialog sequences and a display 
terminal unit operatively coupled to said host computer and to said GMIS unit for enabling a user to 
enter commands directly or through said GMIS unit for execution by said RSF unit, said RSF unit 
further comprising: 

means operatively coupling each of said number of software components to said GMIS unit; and. 

each of said number of components further including a number of modules which operatively 
couple to said GMIS unit, said number of modules being responsive to a different predetermined 
command set containing a small number of commands customized for configuring said each of said 
components. 

The RSF unit of claim 7 wherein said host computer further includes utility and application program- 
ming means for logging errors encountered while running on said host computer and wherein said 
remotely located response center performs support services for said host system by calling back into 
said host system in response to a first component of said number of components having detected an 
overthreshold condition which caused a callout action to be made by said RSF unit for further diagnosis 
and correction of a system problem reported by said host system, said first component further 
including: 

a number of source error log files used by said programming means for logging said errors and a 
control attribute file; 

means for configuring each of said number of source error log files to be monitored, said means for 
configuring causing storage of a source record entry in said control file for each of said number of 
source log files to be monitored, said record entry containing a unique user specified name for said log 
file, a path name to said log file, information identifying the type of log file, information identifying how 
often to scan for new messages and information designating what notification action to invoke if a 
message is detected by said first component as being overthreshold: and; 

means for initiating said notification action specified by said source record entry to said response 
center upon detecting an occurrence of an overthreshold condition within said source. 
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.Record of actions for source "system" 



I Date: Thu Apr 1 14:26:34 1993 

\ ACTION: /usr/bin/callact 

I RESULT: UNSUCCESSFUL (1) 

1 OUTPUT: 

I Performing Callout: Thu Apr 1 14:26:30 EST 1993 
/Error: Invalid message identifier 
/Specified ID is not a hexadecial number: hazel 
/ Date: Thu Apr 1 14:56:05 1993 
ACTION: /usr/bin/mailact 
RESULT: SUCCESSFUL 
OUTPUT: 

Date: Fri Apr 2 12:53:26 1993 
ACTION: /usr/bin/callact 
RESULT: SUCCESSFUL * 
OUTPUT: 

Performing Callout: Fri Apr 2 12:53:19 EST 1993 
Successfully queued callout 
Date: Fri Apr 2 12:53:26 1993 
ACTION: /usr/bin/mailact 
RESULT: SUCCESSFUL 
OUTPUT: 



1^ 

r 



Record of actions on behalf of cluster nodes 



Thu Apr 1 15:36:13 1993 
/usr/bin/netcall 
SUCCESSFUL 



.Date: 
VaCTION: 
(RESULT : 
/OUTPUT: 

Callout on behalf of cluster node fiver 
Successfully sent message to BRC 
Customer Service Request Number: 20823928 
Date: Thu Apr 1 15:39:58 1993 
ACTION: /usr/bin/netcall 
RESULT: SUCCESSFUL 
OUTPUT : 

Callout on behalf of cluster node thayli 
Successfully sent message to BRC 
Customer Service Request Number: 20823929 
Date: Thu Apr 1 15:47:17 1993 
ACTION: /usr/bin/netcall 
RESULT: SUCCESSFUL 
i^OUTPUT: 

Callout on behalf of cluster node hyzenthlay 
Successfully sent message to BRC 
^Customer Service Request Number: 20823930 



FIG. 5c 
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Source Message Database 

PartoflO-md 
Keep file 




stored Message 1 



Stored Message 2 



stored Message 3 



stored Message 4 



stored Message 5 



Stored Message 6 



: ^ Stored Message nl^ 




ID: 


ID Of matching record in the message 


Time Stamp: 


When this message arrived 


Expiration Date: 


When the message expires 


Length of Message: 


Length of the field 


Message Field: 


The message data 


(nriou* hnglh otdiU) 





FIG. 5d 
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ID LABEL 

■i — f 



TYPE CLASS 



w — f 



ERROR DESCRIPTION 



00530EA6 
00«5DS88 
1063B942 
019125F9 
01F2D769 
02288DD6 
0260B082 
02a>4F56 
0299FX)OB 
0375DFC2 
038F2580 
038F3117 
03ACD152 
429B097 
1C8C0 
^66 



DMA ERR 


UNKN 


H 


LAN0030 


Temp 


S 


LUO ConTOp 


PERM 


S 


LAN801E 


Temp 


S 


X25 ALERT2 


PERM 


H 


LAN805C 


Perm 


S 


SDL800E 


PERM 


S 


SDL801D 


PERM 


s 


FDDI NOMBU 


TEMP 


s 


X25 ALERT9 


TEMP 


H 


SCSI ERR7 


UIWN 


H 


MPQP DSRDR 


TEMP 


H 


NB20 " 


PERM 


S 


LAN0853 


Perm 


S 


VCA INTTZ 


TEMP 


S 


SCSI ERRl 


PERM 


H 


SDL0014 


TEMP 


S 


MEM2 


PERM 


H 


CFG BU 


PERM 


S 



UNDETERMINED ERROR 
SOFTWARE PROGRAM ERROR 
CONFIGURATION OR CUSTOMIZATION ERROR 
SOFTWARE PROGRAM ERROR 
X-25 RESTART REQUEST BY X.25 ADAPTER 
SOFTWARE PROGRAM ERROR 
SOFTWARE PROGRAM ERROR 
SOFTWARE PROGRAM ERROR 
RESOURCE UNAVAILABLE ERROR 
X-9FRAME TYPE W RECETVED 
UNDETERMINED ERROR 
COMMUNICATION PROTOCOL ERROR 
SOFTWARE PROGRAM ERROR 
SOFTWARE PROGRAM ERROR 
Host independent initialization failed 
ADAPTER ERROR 
SOFTWARE PROGRAM ERROR 
Memoo failure 

ConTiguration failed :ad bus type 



SYSTEM LOG FILE 



\run 23 08:54:51 TP^lnlt: Can't allocate memory for first lOPB 
Jun 23 13:02:42 Feedback from MVU-MS does not indicate movement 
Jun 23 13:02:46 Controller retries attempted before command completed 
Jun 23 13:02:46 Can't allocate message buffer 
Jun 23 13:02:51 Dlegal (odd) count speciHcd in S/G list 
Jun 23 13:03:51 Video signal missing from TP module 2 
Jun 23 13:02:55 Cannot start motor (4:2): fail, sense key is 0x2231 
Jun 23 13:02:55 Cannot activate MVU 4 of TP module 2 
Jun 23 13:03:57 Audio signal missing from TP module 2 

Jun 23 13:03:59 Status reg 0x02, Bank 0x0003, Syndrome OxFFFF, err on TP 2 

Jun 23 13:05:00 Can*t flush/unmap unit structure 

Jun 23 13:05:00 Address not mapped properly 

Jun 23 13:05:01 Can't dump more than 512 MB physical memory 



ASCn LOG FILE 

FIG. 5e 
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SAMPLE SEQUENCE OF RSF CONFIGURATION STEPS 



Install 



00 I 



B 



Configure An 
ASCII Source 

Fig. 7c 002 



Configure a 
System Source 

Fig. 7c 003 



I 



Configure 
Callout 

Fig.7d,7e 004 



i 



Configure 
Callback 

Fi9.7f,7g 005 



Configure 
Diagnostic 

Fig.7h 006 



Configure 
Daemons 

Fig.7i 007 



From GMiS Untt 

104 



FIG. 7a 
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780 




(TO FIG. 7<R) 



PERFORM tONRGURE 
OLUOUT (lOCM. UOOQI)* 



j: 



753 



OtSPUY SUBMENU Wni 
SriE PARMCtlRS. 
MOOQI PARAMOIRS 
WS^ OLUCXJT TUNING 



FIG. 8e 



ISELEa *SnE PWWIEltlg' 



KSaAY SUeiffNU WTH 
SET SrSIOl DENHFER. 
RC PHONE NUUBER. 
AM) OnCR SITE 
PMIWEIERS AS SHOWN 



756 



FKS. Bf 



-758 



ISET *SffE PARAfctiren FIG. 7e 
i ^760 



iSSia 'RC PHONE NUCEFS'I 



nSPUY SUBUE}AJ WTH 
UST RC PHONE NUIffiER. 
ADD RC PHONE NUffiER. 
* DQ£IE A RC PHONE 
NUIfflER AS SHOWN 



-762 



FIG. 8g 



CHOOSE 'ADO ARC L. 
PHONE NUICER* ^ 



FK. 8h 



766 



ENTER PHONE NUU8ER FOR RC 
AND EXEOHE DIALOGUE 




»O(0UTT0ntE "snE 
PARAMETERS ' MENU 



I 



770 



SE1£CT 'OTHER SnE 
P/«AMETERS*__ 



FIG. 



772 



774 



ENTER OPERATOR NAME. OPERATOR 
PHO»C NUMBER. SYSTEM PHONE 
NUMBER. REMOfTE PASSWORD. 
TIY PATH AND SMKl ADDRESS. 
EXEOm: Dm)G 



BACK OUTTO 
O^JUOOT (LOCAL MODEM)' 
MENU 



, ^776 

COMTGUWEK 

FIG. Be 



RSF MODEM^ 
BONG USED THE 
^PRECONFIGURED 
MOOQf? 



(TO FIG. 7d2) 



(TO FIG. 7d3) 



FIG. 7dl 
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(IN FROM FIG. 7d1)- 



((N FROM RG. 7d2) 
PERFORM XMlMf 



MAWGEiefT'SECJUENCE 



(M FROU FIG. 7d1) 



852 



OtSPlAY SUBMENU WH UST 
QUEUED CALL0U1S, SHOW 
A QUEUED CAUjOUr 



I 



FIG. 8p 



834 



safer tHANGE / SHOW 
CALiOUr MANAGER STATUST 



ENTER DELAY eEPNEEN CMiOUTS 
A^f} MIOQMIAI OmiE lENGTR 
DlBXm DIALOG 



^836 
FIG. 8q 



I 



837 



SElfCT "^ART CAODUr 
WmXR OAEMON' 



FIG. 8r 



DIALDG ASKS *NOW. AT SYSIEM 
REBOOT OR BOTH?' . SELECT fiOIH 
AND EXECUTE DMjOG 



839 



850 



PERFORM tONFIGURE 
CALLDUr (CUUSIER CUENTy 



I 



DISPIAY SUBMEMi WTH SET 
SrSTEM IDENIVIERiW 
SET OflHER W«AMETERS 



852 
FIG. 88 



854 



ISET SYSTEM IDENTHERI 



I 



SElfCT MOTHER 
PARWyETERS' 



856 



I 



r 



ENTER OPERATOR NME. 
OPER/OOR PHONE NUMBER. 
REMOTE PASSWORD. 
OUSTER SEINER AND EMAL 
ADDRESS, EXECUTE 
DIALOG 







858 



FXX 8t 



FIG. 7d3 



FIG. 7d4 
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f 



900 



[PERFORM "COHFIGURE CAUfiACX* 

r . 



aSPlAY A SUBMENU WHH CONFIGURE 
PERMISSIONS AND CONFIGURE MONITORING 



I 



,902 



FIG. 9a 



904 

SEIEQ 'CONFIGURE PEFMBSIONS^ FIG. 9b 




SET "REMOIE SERVICE DW.-W 
TO BE OlSABlED 




SET 'REMOTE SERVICE OVMN* 



912 



TO BE ENABLED 



J 



-916 



SET 'ALLOW ROOT PRMiEGESr 
TO YES. EXECUTE DIALOG 



I 



SET 'ALLDW ROOT PRIVILEGES" l/ 
TO YES. EXECUTE tXALDG 



009 /T 



920 



CONFIGURE MONITORING 



"J 



918 



FIG. 9c 



FIG. 7f 
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PERFORM tONFlGURE MONnrOWNG^ 
920-2 




920-6 



SET 'SESSION NormcAnoN 
mmm' ro mo 




920-10 



920-12 



SET 'SESSION LOGGINGr TO NO 




N ^920-20 



SET 'ENABl£ EMAIL ON 
CALL-IN' TO NO 



jC 



920-24 



ENIER 'TERWNW. TYPE FOR 
CALLBACK' . EXECUTE DWLX 



X 



920 



920-4 



SET 'SESSION NOTTICAnON 
IWTERACnVE* TO YES 



920-8 



IPERPORM 'NOITFICATTON DEVICE] 



20-14 



SET 'SESSION LOGGING' TO YES 



T 



920-18 



SET *ENABl£ EMAIL ON 
CAUL-IN' TO YES 



920-22 



, ♦ r 

jam 'tun, naess- 



FIG. 7g 
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T 

I PERFORM 'ACIIOWS' \ 



OiSPlAY A SUBMENU WKH SHOW RSF 
STATUS. START RSF DAEMON^.. 



I 



FIG. 10a 



z: 



934 



SELECT tONRGURE DiAGNOSncr I RG. 10b 




SET tNABLE DMGN0ST1C' TO NO. 
EXECUTE DIALOG 



^938 



SET 'ENARE WAGNOSTIC' TO YES 



942 



SET FREQUENCY EXECUTE DIALJOG 



FIG. 7h 
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950 



PERFORM >CTCi»gn 



I 



^1 

nSPLAY A SUBMENU WnH SHOW RSF 
STATUS. START RSF DAEMON.. 



952 



FIG. lOo 



SELECT 'START RSF DAEMON' 



IZ2 



956 ^FIG. 10b 



DIALOG ASKS 'NOW. AT SVSmi 
REBOOT OR BOTH?' . SELECT BOTH 
AND EXEdJlE DIALOG 




960 



SELECT 'START CUBIER DAEMON' 



I 



FIG. lOd 



962 



DMjOG ASKS 'NOW. AT SYSTEM 
REBOOT OR BOTH?* , SEUCT BOTH 
AND EXECUTE DIALOG 



RG. 7! 
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Install Software With Updates 

Type or select values in entry fields. 

Press Enter AFTER aaking all desired changes. 



[Entr^ Fields] 



INPUT device / dire ctory for software /dev/ 

M*lifl'.7iUtMtf-ajiLiJilII ^ , (Qii) ^ 

Automatically install PREREQUISITE software? no ♦ 

COMMIT software? no + 

SAVE replaced files? yes ^ 

VERIFY software? no ♦ 

EXTEND file syst.ems if space needed? yes 

REMOVE input file after installation? no ♦ 



Fl«Help 

Esc4-5«Undo 

Esd^SsShell 



F2«Refresh 

Esc*6«Com««nd 

Esc+0=Exit 



F3sCancel 

Esc+7«Edlt 

Enter-sDo 



F4eList 
E5C'*'8nXMage 



FIG. 8a 



Ty 
Pr 



Install Software With Updates 



SOFTWARE t.o install 



I/U O Coiitont 



Move cursor to desired item and press F7 . 

ONE OR MORE items can be selected. 
Press Enter AFTER waking all selections. 

[TOP] 



ft Option Name 



rsf .all 

i Description: Will include ALL the images for rsf. 
f 

rsf . rsf . ob j 00. 17 . 0000 . 0000 

i RSF (Remote Services Facilities) Software, Remote Se I H usr^root 
i 

[MORE... 21} 



Fl 
Es 
Es 



Fl»Help 

Esc'f7MSelect 

Enter^Do 



F2BRefresh 
Escf Solmage 



F3^ancel 
Esc-fO«Exit 



FK5. 8b 



Add a Source 

Type or select values in entry fields. 

Press Enter AFTER making all desired changes. 



Soitrco Iciontltior 



Source Path 
Action 

clfeantlme 
Search time 
InitialiEatXon File 



I? 



(Entry Fields] 



(] 

(ASCII] 
(1-day) 
(5 -hours] 
{] 



Fl«Help 

Csc-f5«Undo 

Esc-«'9»Shell 



F2BRefresh 

Esc-fG^ommand 

Esc+0«Exit 



F3«tCaBcel 

Esc4-7-£di.t 

Enter»Do 



F4«List 
Esc -t-SM Image 



FiG. 8c 



'SOOCID: <EP 0632382A1J_> 



125 



EP 0 632 382 Al 



Add a SYSTEM Message 

Type or select: values in entry fields. 

Press Enter AFTER making all desired changes. 



Source Identifier 



Mossnqo Identiticr 



Threshold 

Duration 

Keepmax 

Initialization Fila 



[Entry Fields] 
BVEtam 

I?, 

ll-day) 

(20] 

(3 



♦X 
♦f 
♦ 

t 

/ 



Flttllelp F2»Re£resh F3=Cancel F4aList 

Esc+5=Undo Esc+6=Coi««and Efic47«Edit Esc*8-I«age 

Esc+9"Shell Esc+0=Exit Ent«r«Do 



RG. 8d 



Configure Callout (Local Modem) 
Hove cursor to desired item and press Enter. 

Modem Parameters 
Callout T\ining 



Fl«Help 
Esc49=Shell 



F2ERefresh 
Esc4-0=Exit 



F3«Cancel 
Enter^Do 



Esc-t-S^Xmage 



RG. 8e 



Site Paraneters 
Hove cursor to desired item and press Enter. 



Fl-Help F2«Refresh F3>K:ancel Esc*a-Image 
Esc-f-d^Shell EsO-0-Exlt Enter«De 



RG. 8f 
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BRC Phcn« Rumbers 
Hove cursor t,o d«slred i^eia and press Enter. 



List BRC Phone niitrJ)orf;i 



Add a BRC Phone Nuiiber 
Delete e BRC Phone NuMber 



FlBHelp F2eRefresh F3«Cancel Esc-t-Sts linage 

Esc*9«SheIl Esc+O-Exlt Enter«Do 



FIG. 8g 



Add a BRC Phone HuKber 

Type or select: values in entry fields. 

Press Enter AFTER Making all desired changes. 



BRC Phone Number 



[Entry Fields] 

(0 



Fl«Help 

Esc-fSviUndo 

Esc^9»Shell 



F2>=Refresh 
£s c SaComMand 
Esc-t-0>Exlt 



F3eCancel 

Esc+7«Edlt 

Enter^Do 



F4«Llst 
Esct-Swlmagc 



FIG. 8h 



Set Other Pa 



Type ox select values In entry fields. 

Press Enter AFTER Making all desired changes. 



Operator Phone RuMber 
System Phone HuMber 
ReMote Password 
TTY Path 
E-Mail Address 



[Entry Fields] 
ohn H. Jones] 
[506) 555-3325] 
>085556275] 
[phoenix] 
[/dev/ttyl] 
(root) 



[Skh 
((50 
(508 



Fl-Help F2-Refresh F3«Cancel F4«iList 

Esc4>5««Undo Esc'»-6<«ConMand £sc*7*Edlt Esc^-S-XMage 

Esc-«-9sShell Esc-t-OaExit Enter«Do 



FIG. 81 
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Move cursor t:o desired Iten and press Enter. 




Connect Str Ing s 

Other Modem Paraneters 




FltHelp F2i=Refre5h F3«Cancel 
Esc+9»Shell Esc+0«fExlt Enter»Do 


Esc-«^8Blmage 


FIG. 8J 


OK Strings 




Hove cursor to desired item »nd press Enter. 




Add OK String 
Delete OK String 




Fl-Help F2«Re£resh F3«CanceX 
£sc<^9*ShelX Esc-fO=^Exit Enter^Do 


Csc-«-8wImage 


RG. 8k 


Add OK String 




Type or select values in entry fields. 

Press En^er AFTEB making all desired changes. 






[Entry Fields] 

KD 


Fl«Relp F2«{t«fresh F3-Cancel 
Esc4>5«Undo Esc4'6»CoMaand Esc<f7aEdit 
Esc+9-Sh«ll Esct-O^Exit Enter*Do 


F4-List 
EscfS^Isiage 


FIG. 81 
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Connect: Strings 
Kov« cursor <i«slre<l i.t:eM and press Ent.er. 



List Connect Strinqs 



Add Connect String 
Delete Connect String 



Fl«Help F2«Refrevh F3=C«ncel Esc+8-Iwage 

Esc^SaShell Esc+0«Exit Enter«Do 



FIG. 8m 



Add Connect String 

Type or select values in entry fields. 

Press Enter AFTER making all deslr>ed changes. 

[Entry Fields] 



Fl»Relp 

Esc^SwUndo 

Esc-»-9«Shell 



F2«Re£resh 
Es c <*■ 6*CoMna nd 
Esc-fOaExlt 



F3«Cancel 

E8c47«Edlt 

EntereDo 



F4»Llst 
Esc«8">lMag« 
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Other ModttM Parameters 



Type or select values in entry £lelds. 
Preaa Enter AFTER Making all desi.red chang« 



MIIP Soloctloii 



Callback Condition String 

Callout: Condition Storing 

Dial Steing 

Redo String 

Dlaconnect String 

Hangup String 

Busy Storing 

Charactier Size (bits) 

Stop Blt,8 

Parit:y 

Baud Rate 



l»Help 

E8c45>Undo 

Esc49«Shell 



F2"RefreBh 
Es c 6^oima nd 
Esc^O-Exlt 



F3«>Cancel 
Esc47«iEdit: 
Enter»Do 



(Enrry Fields] 
liDo] 

|ATftFE0Q2S0«lCD0*Fl4W) 
[AT&FX5VOEO«C0) 
[ATDT] 
I A/ J 

lATHO] 

{'I 

(1) 

[none] 
[36400] 



F4«I.lst 
Csc4'B«lHag« 



♦ft 
♦t 

♦ 

♦ft 
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Callous Hanacjement 
Move cursor to desired IteM and press Enter. 



List Qiiouotl Cal louts] 



Show a Queued Callout 
Remove a Queued Callout 
Show Callout Hanaoer Status 
Ch«n<ie / Show Callout Manager Status 
Start Next Callout 
Re-start Failed Callouts 
Display Callout Records 
Reset Callout Records 
Start Callout Managenent Daemon 
Stop Callout Management Daemon 



FlBllelp 
Esc+<>«Shell 



F2«Re£resh 
Esc+0=Exit 



F3^ancel 
Entors^Do 



Esc-t-S^Image 



FTG. 8p 



Cliange / Show Callout Hanager Status 



Type or seleot values in entry fields. 

Press Enter AFTER making all desired changes. 



Delay Between Callouts 



Maximum Queue Length 



(Entry Fields) 
— • 
OJ 



igO-mins] 
120 



Fl«Help 

Esc-fSKUndo 

Esc-t-d^Shell 



F2«Re£resh 
Esc 6vCommand 
Esc+O-Exit 



F3eCancel 

Esc*7"Edlt 

Enter^Do 



F4«List 
EsG«S>Ima9« 



FIG. 8q 



Start Callous Management Daeaion 



Type or select values in entry fields. 

Press Enter AFTER making all desiz-ed changes. 



^h^ngo Daomon Now, At System Reboot, or Both? 



(Ent.ry Fields] 
li&owl 



Fl«Help 

£se^5>Undo 

Esc-fd-Shell 



F2»Ref resh 

E s c 6sCo«m a nd 

Esc^O*Exit 



F3«CanceI 

Esc4.7«Edit 

Enter»Do 



F4-List 
Esc4>8«Ima9e 
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Confi<jure Cailout (Clust:er Client) 
Hove cursor to desired Itew and press Enter. 



Sot System Idetititler 



Set Other PeraMeters 



FloHelp 
Esc-*-9"Shell 



F2c=Re£resh 
Esc*0=Exit 



FSaCancel 
Enter«Do 



Esc^SvIiaage 
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Set Other Paraneters 

Type or select values In entjry fields. 

Press Enter AFTER aaiclnq all desired changes. 



Operator Phone Nupiber 
Reaote Password 
Cluster Server 
E-Mail Address 



(Entry Fields) 
'Dohn H. Jones) 
;750e) 555-3325) 
phoenix) 
^hecel) 
[root] 



Fl«Help F2«&«fresh F3«Cancel F4-Ust 

Esc«5»Undo Esc^6«Coaimand Esc-f7*Edlt Ese48«I»a9e 

E8c«9«Shell Esc40»exlt Enter-Do 



FIG. 8t 
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Configure Callback 




Hove cursor 


to desired Iten and press Enter. 




■ Coiilin\iro 






Configure 


Monitoring 




Fl"Help 
Esc*9«=Shell 


F2»Refresh F3nCancel 
Esc+0»Exit Entex'sDo 


Esct-d^Image 



FIG. 9a 



Config^ire Permissions 






Type or select values In entry fields. 

Press Enter AFTER making all desired clionges. 






Allow Root Privileges 


[Entry Fields] 
iSlsabled 
YES 




Fl-'Help F2-Refresh F3«C«nc«l 
Esc•^5«Undo Esct-e^oMiand Esct^T^Cdlt; 
Esc49«Shell Esc-f-O^Exlt Enter»Do 


F4«Llst 
Esc <»9« Image 




FIG. 9b 


Configure Monitoring 






Type or seX«ct values In entry fields. 

Press Enter AFTER sieklng ell desired changes. 






Hotlflcatlon Device 

Session Logging 

Enable E-aall on Call-In 

E*m11 Address 

Terminal Type for Callback 


(Entry Fields] 

(0 

I/dev/console] 

li 

(root] 
(vtlOO] 


♦ 

♦ 


ri-Help F2«&efresh F3-Cencel 
Esc^5«Undo Esc^6->Comm«nd Esc*«-7«-Edlt 
Esc-i>9mShell Esc^-O^Exlt Enter*Do 


F4«I.lst 
Esc-^daaXmege 
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Actions 

Hov« cursor t.o desired ite« and press Enter. 

s-nnmM«aiiLim 

Start RSF Daemon 
Stop RSF Daemon 
Start Cluster Dae»on 
Stop Cluster DaeMon 
Display Record of Actions 
Reset Record of Actions 
Config%ire Diagnostic 
Show Diagnostic Settings 



Fl^Help 
Esc<*^9BShell 



F2=Rcfresh 
Esc+0=Exit 



F3E=Cancel 
Entcr=Do 



Es c 8 » X»ag e 



FIG. lOa 



Con£igiii-e Diagnostic 

Type or select values in entry fields. 

Press Enter AFTER making all desired changes. 



Etiable Diaqnostlc? 



[Entry Fields] 
(Qes] 



Frequency 



[MONTHLY] 



Fl-Help 

Esc^-SaUndo 

Esc4^9«Shell 



F2«Refresh 

Esc^G^onmand 

Esct-O^Exit 



F3nCancel 

Esc*7-Edit 

Entera>Do 



F4»Lls^ 
Esc'*>8i"lMage 



RG. lOb 



Start BSF Daemon 

Type or select values in entry fields. 

Press Enter AFTER making all desired changes. 



hnnqo RSF Action Now, at System Reboot, or Both? 



[Entry Fields) 
(SSowJ 



Fl«H«lp F2«Refresh F3«Cancel F4«Llst 
Esc^5«Undo Esc«6«Command Esc«7«Edlt Esc-fS-Image 
Esc49mShell Esc-*-0»Exit; Enter»Do 



FIG. lOc 
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Start Clustar Daanon 

Type or select values in entry fields. 

Press Enter AFTER Making all desired changes. 



CItanqe RSF Action Now. at System Reboot, or Both? 



(Ent:ry Fields] 
iDowJ 



Fl«|]«lp F2BRGfresh F^^^Cancel F4»I*is^ 

Esc-«>5»Undo Escv-G^Command Esc>7BEdit Esc^8«I«ag« 

Esc+9»Shell Esc-^0=Exit EntereDo 



FIG. lOd 
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FIG. I la 
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SEARCH 
(Rg. lid) 



START 




SETUP 
(Fig. 11c) 



.1100 



WAIT FOR 
NEXT EVENT 



,1102 




1104 



SCHEDULE 
NEXT 

OCCURRANCE 
OF THIS EVENT 



I 



-1106 



DISPATCH 
BASED ON 
EVENT TYPE 




•1107 



1112 



CLEAN 



DIAGNOSTIC 



DONE WITH 
EVENT 



1114 



FIG. lib 
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(^TART^ 



OPEN SOURCE 
ATTRIBUTES 
DATABASE 



1100 



1100-2 



1100-4 

'WHILE' 
THERE ARE 
^ARE UNREAD 
lECORD 



O MORE 



jL 



1100-6 



READ DIAGNOSTIC 
CONFIGURATION 



MORE 



1100-10 



BEAD RECORD INTO MEMORY 
BUILD INTERNAL LIST 



I 



IS 

DIAGNOSTIC 
ENABLED. 



END 



z 



1100-12 



USE SEARCHTIME TO 
SCHEDULE A SEARCH EVENT 
FOR THIS SOURCE 



I 





Ty 1100-9 




USE DIAGNOSTIC 




FREQUENCY TO 




SCHEDULE A DIAG 




EVENT 





z 



1100-14 



USE CLEANTIME TO 
SCHEDULE A CLEAN EVENT 
FOR THIS SOURCE 



FIG. lie 
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REM) ICSSAGES 
FROM LOG nL£ 
FOR SOURCE 



1108-2 



1108 



NO UORE 




USE SOURCE TYPE TO 
DETERIANE WHAT 
ROUIM: TO CALL TO 
READ MESSAGE 



1108-6 



ASCH 



1108-8 





SYSTEM 



READ AN ASCII 
MESSAGED 



READ AHOSr 
SfSTEM ERROR 




USE SOURCE TYPE TO 
DETERly^ WHAT 
ROUHNE TO CALL TO 
SEARCH THE UESSH£ 
TEMPLATE DATA»^ 
FOR A MATCH 



1108-12 



ASQI 

USE REGULAR 
EXPRESSION 
MATCHNG 




USE ERRORS) 
TO FIDMATCHIIG 
MESSAGE TEMPLATE 



1108-14 




1108-18 



UPDATE COUKTK ^^^^"^ 



1108-22 




1108-24, 



EXECUTE ACnON 
FOR SOURCE 



FIG. IkJ 
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1220 




1202 



QUERT 

CONFIGUfWION 
FOR TEKMNM. 
TYPE TO BE USED 
FDR CALLBCK 



1204 




1210 



SET TERM DMRON- 
MEKTAL VARUBl£ 
TO DEFAULT OF VTIOO 



SCTTERM OMRON- 
UEK1AL VARABlf 
TO THE CONRGIA^ 
VALUE 



DtSPlAY PROPRETARY 
MESSAGE 



I 



1212 



QUERY CONRGURAnON 
FOR EHyML ADDRtSS TO 
SEKD NOFmCAnON OF 

LX M/our 



1214 




121B 



SEM) E-U«.TOT>C 
C0W1GURED ADDRESS 
NOnFYMG OF LOG M 



OUERY CONFIGURAIION 
FOR WHOHER OR NOT 
DiRECr-TD-TERIIIMAL 
trOERACm OR S£SSK)N 
MONTTORING HAVE BEEN 
ENABLED 



1226 




J 224 



BUU) CAUSCRFT COUyAND 
L0C: MX) ARGIACNTS TO 
F^aUTATt 0«e;T-TO- 
TERUm. UONITORING 



1228 



BUaD CmSCRfPT COIOMfl) 
UNE: ADO ARGUCNTS TO 
FiCa/TATI SESSKM-NOrmTION- 
ftOERCnVE MONTTORING 



1252 



BUU) CMISCRPT COimAM) 

L»e ivx) iv«;uiens TO 

FACILITATE SESSION LDGGMG 



1236 



RUN CAUSCRrr HITH /WGU- 
lanS TO RUN GUS WITH 
ARGUUEHTS ON BULT 
COKUAND UNE 



FIG. 12b 




1242 



SEND E-4I^T0 
THE CONFIGURED 
ADDRESS NOWY- 
MGOFUDGOUT 



1244 



y^- tQ£ANUP AND Exrrl 



"5" 
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1250 



DOREMOTE RUNS AS A 

SETUID PROGRAM TO 
OBTAIN SUPER-USER 

PRIVILEGES 



1252 



EXAMINE COMMAND 
LINE TO DETERMINE 
WHICH PRIVILEGED 
TASK IS REQUESTED 



I 



1254 



QUERY CONFIGURATION 
TO DETERMINE IF THE 
TASK IS ALLOWED 



1256 




PRINT PERMISSION 
DENIED ERROR 
MESSAGE 




PERFORM 
THE TASK 



FIG. I2c 
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Callback Adninlstration 




Hove cursor to desired It^em and press Enter. 




List Over Threshold Messages 
Root Login 
User Login 
Run GHIS 




FlsHelp F2«Refresh F3*sCancel 
E5c>9sShell Escf^O^Exit EntersDo 


Esc^SvXaiage 


FIG. I2d 
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I 



1300 



PARSE COMMAND 
LINE ARGUMENTS 
BUILD LISTS OF INPUTS 
AND OUTPUTS 



1302 



START SUBSHELL 




FIG. 13b 
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(sTAR-n 

^•J^ ^ 1350 



CHECK FOR 

CURRENT 

SESSION 



1352 
iOES"--^^ N 
THE CURRENT 
SESSION FlU 
EXIST 
?. 

1354 



NVOKE SHOWSCRIPT 
IWITH CURRENT SESSION 
FILE AND PID FROM 
PID FILE 




END 



1356 



DISPLAY 

INFORMATIVE 

MESSAGE 



RG. 13c 
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1360 



PARSE 
ICOMMAND LINE 
ARGUMENTS 



I 



1362 



READ FROM 
SESSION FILE 
AND WRITE TO 
TERMINAL 



V 



1364 




1370 
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CLEANUP 
AND EXIT 



1374 




1366 

WAS^ 
PID SPECIFIED 

IN COMMANO- 
JNE? 



1368 



SEND KILL 
SIGNAL TO 
PID 



1372 



HANDLE OTHER KEYS 



FIG. 13d 
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;RecoirT:l of actions for source '^system" 



Date: Thu Apr l H;26:34 11)93 
ACTION: /usr/bin/call^ict: 
RESULT: r.FNiSOCCESSFlJL (1) 
OUTPUT 4 

P^irforming Callout^ Thu Apr l 1^3; 26: 30 EST 
Error; Un^flilid iteBsage i.fSenttfier 
Specifi.ecl ID is not a hoxadeciaL nurriber: hazel 
I>ate: ThTi A^r 1 14:56:05 19 93 

ACT I ON r / u^r/bin/iriciilact 
RESULT : SUCCESSFUL 
OUT?aT : 

Datfe: Fri Apr 2 12:53:26 199i 
ACTlOWi /us r/b In/call act 
RESULT: SUCCESSFUL ' 
I OUTPUT: 

1 Performing Calloutt Pri Apr 2 12:53:19 E;£T i993 
1 Successfully queued callout 
lDat$; Fri Apr 2 1^353;26 199:5 

lACTIObf: /usr/bin/ftiailact 
RESULT: SUCCESSFUL. 

^OUTPUT; 




Racora of actions on behalf of cluster nodes 

^Date: Thu Apr 1 15:36:13 1393 

^IOM^ /ucr/bin/netcaii 
lE^ESULT; SUCCESSFUL 

/output 5 

Callout on behalf of eluetej? node fiver 
Successfully Bent message to BrC 
CUBtoiner Service R^uegt Number: 20523926 
Date: Thu Apr 1 15: 39- SB 1993 
ACTION; /Tjsr/bin/n^tcall 
RESULT; SUCCESSFUL 
OUTPUTS 

Callout on behalf of cluster node thayii 
Success fully sent mesBage to BRC 
Customer Service Request Nuntbarj 20833929 
Dater Thu Apr 1 15:47:1? 1993 
ACTION: /usr/bln/netcall 
RESULT I SUCCESSFUL 
^OUTPUT: 

callout on behalf of cluster node hyzenthlay 
Succe£^a fully ^ent mes^a^e to BRC 
iCuBtomer Service Request Wumber: 20823930 
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Source Messsge Database 

KBBp HiB 



Stored llMBage 2 



Stored Heaaage 4 



Stored }A««8&9» 5 



Stored Il!9nfl09 6 






ID of match^ record in the mssMge 


Ttma Stamp: 


When thts iMft6ag» airlved 


BcptratfonOffte: 


When the meeedge explraft 


iMQthofMMsage: 


Length of the Held 




Tti9 message data 
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eSJtOR I>ESCIl[Fr[OK 



mjOEAtf DMA VNKH H UNDETESU^ONED ERROR 

C^5D^$ L^V)0i3O Temp S SOPTWARB FROGRAAt ERROR 

Iim$4I LUO CanfOp PeAAf £ CONFIGURATION DR CUST0^4l^AT^0^f ERR t>R 

<1L9125F9 LANflOlE Tmp 5 St^Fn^'ARS FROORAM ERROR 

QiPil>7«» X15 ALERT2 PERNf K RBSTART REQUEST HV XJ5 ADAPTER 

'i fl22«SDD« LAWBWC Pttm 5 SOFTWAJRE PROGRAM ERROR 

I fl2f»B03I £33LM(K£ PCKfLf $ SX^FTWARS t>ROORABlI ERROR 

Q2ro4F55 SQUrair PERM 3 SOFTWARE PROORAM ERROR 

/ 0299F1}€D FDD! NOMDU TBhlF S ftlS^OURCE UNA VAILAELS ERROR 

/ 0375DPCi X15 AL32RT? tmO^ H X-5FRAME TYPE W RECEIVED 

/ C^M^'lS^fi 5CSI_ERR7 UNKN H UNDETERMINED ERROR 

OSBEill? MPQP_I>SR]>R TE^^P H C0MMU^aCATJON PROrOCOL »WOR 

\ fl3ACOI52 NB2fl P£R^f S SOFTWARE PROGRAM ERROR 

\ 42SBC97 LAMI353 Ptnn S SOFrMTARE PROGRAM ERROR 

\ ICftCO VCA.INrrz nSM^ S HoH i^defietfidefit IntUaElsatlon failed 

^<^( SCSi BRAJ PERM H ADAPTER ERROR 

5DLM14 TEMP 5 SOFTWARE PROGRAM ERROR 

MEM2 PERM H Mtfnoiry fkilun 

CFG.BU PERM « CopfijnPnUon WW:4id bus «jpe 



SYSTEM LOG FILE 



^Jua23 (M:34:5l TP.lnJt; Can't ftU^catc iDcmory for Gtst lOPB 
Jtia 23 133C:t:42 Feedback trcm MVU-MTS does oot indicate movemeai 
Jun 2} 11:01:^ Cantrallcr rrfric^ AlE^^mptcd b^rorc coixntiBind comptefed 
Jan 23 13:0i:4ti Can't etllocale m^ssa^e buffer 
Jua 23 13:0Z:5I DJegal (odd) coiicit 5iwcincd In S/C list 
Jun 23 13:03:51 Video signal cnlsslcg tiom TP module 2 
Jud 23 12t0ias Cannot start molor (4:2): lail^ sense key Is 07^2231 
Jud 23 13:01:55 Cannof act Ivaf t MVU 4 of TT module 2 
Jud 23 13:03:57 Audio stgnfil mlsstug from TP module 2 
Jun 23 13:03:59 Status reg 0x02, B3Dk Os0003i Syndrocne OjftTFFp «rr pn Tt> 2 
Jun 23 13:05:00 Can't nush/unmap unit stiucture 
Jud 23 13^05^00 Addr^ not tnftppcd properly 
Jun 2} 13s05rOI Can't dump more than 512 MD ph>sl£fil mcmorjp 



ASCnr LOG FILE 
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000: SAUPLE SEQUENCE OF RSF CONRGURATiON STEPS 



tnstalt 



00 I 



B 



Cciiiflsur»Aii 
ASCII Souriifl 

ng.7& 002 



Configure a 
System $our«e 

Flfl*7e 003 



i 



Conflgur* 
Caltout 

Fig»?d,7e 004 



I 



Cortflgura 

Ftfl-7^^7B OPS 



± 



Cdnflgurt 

FIS.7h 006 




FramGMO Unit 
1M 



>_0632382A1TL> 



114 



EP 0 632 382 A1 




EP 0 63i 302 A1 




EP 0 632 A1 




{10 na. 



y?5g 



I 



j: 



7M 



I SELECT ""^^mS^ 

i 



1^ B9 



754 



HSPlAf SUBiCHU WIH 



ncrair 



75a 



NLMER AS 




OUTT&THE 'SHE 



I 



770 



F)C 



772 
3! 



I 



mONE NUWGE^ StSTEH PHCtC 



&WC MIT TO 

MEHlf 



, ^77« 



Tip 

UQDQf? X (TO W3) 



(TO PC. 7d23 



FKx 7dl 



SDOCIO: <eP 0632382A1TI_> 



ir? 



EP 0 S32 3^2 Ai 




EP 0 £3;2 382 A1 



{iNfFilHCFIK 7dO- 



{IN FRM m. 7<^ 



(H FJWW FIG. m) . 



ELS 



AQUEUiD OaJUF 



I 



sajEcr twNce / shqi 

OUjOUr WNWER STAIUS' 



ENTER CElAr BE1«E» CNiOTIS 

M muM wot. \smn. 



I 



H57 



ttlHT '^Afiir CUUDJT 



REBOOT OR fiCflHT'' . 



oauii/t {OLusitB tazNiyi 



866 



I 



«2 



nSIIM SENVFER MD 
SET OnCR PWWEIEAS 



BE4 



SEiiicr ^ cn& 



fiEUHE PffSStnM, 
CLUSTER SEMR in tlM. 
WVOSi EVECUIE 



Fic. a 



FIG. 7d3 



FIG. 7d4 



300CID: <EP 0632382A1TI_> 



IfQ 



EP 0 &32 3a2 A1 




50OCI0: <EP_0632382AlTt_> 



120 



EP 0 632 382 A1 



-900 



. 1 C 

usmf k suBMEru im oomdcure 

POiySSIONS m COHFlflURE yOHTORIHG '^"*' ^ 



904 

mgr 'coNFtQUffi PtBMisgctfsn FKJ. 9b 




SET 'REyOIE SERVICE DM.HN' 

IIP m oswH? 




4 

SET 'fSMOlE SERVICE OUt-irr 



912 



TO EE EK«a£D 



SET 'ALijOi AOOT RWIIj 
TO rt& EXECtllE DWL06 



I 



SET 'AliJCW RbOT PRMCEE7 i/ 
TP YE. EXEOre CWJDC ^ 



92D 



CONFIGURE UONdmHS 



"J 



9f8 



FKi 7f 



StXXID: <EP 0632382AlTt_> 



121 



EP 0 d32 3i2 Ai 




920-2 




920-6 



SET "SESSKN WOFICAIION 
IKTEHACnvE' TO l» 




^10 



S20-12 



1 SET 'SESSIQW ibOGINg TO NO 




1-16 



SET 'WBUl Omi ON 
CftLLHff TP NO 



920-24 



Om "THMWl TffE FDR 



I 



ago 

920-4 



so 'SESSION MFTmnON 
IWERftgrVE^ TO YB 



^20-14 



SET 'SESStON lOGGiNG* TO >CS 



920-(S 



SET 'DMlf EMAIL W 
CWi.-IM' TO YES 



«2a-22 



ENTER 'EWLMWffiSS' 



no, 7g 



SOOCIO: <EP 0632382A1TI_> 



122 



EP 0 632 382 A1 



i r 

PERFQfly 'ACTIONS' 



I 



932 



-Jl 

DISPUY A SUBMENU WA SHGW RSF 



rx. 10a 



i SELECT tOfflBURE MACHOSHCn "C- 1* 




SO- tMAOf DMGN0ST1D' TO NQ. 
EXECl/TE DIALOG 



T 



j aET ^BWE IWCWOSTIC' 10 YES | 



SET FREqUNCr EXECUI£ DMXMS 



FIG. 7h 



SOOCID: -cEP 0632382A1TL> 



123 



EP 0 B32 Ai 



nspiAY A siimnu m\ show rsf 

SWUS, Sr/W RSF D^gMOW... 



FIG. 1(k 



saia 'swrr rsf memqn' 



966 



DIALOG ASKS 'NOW, AT SY5TIM 
REBOOT {» BOTH?*, SELHT fiOm 




RG. 10b 



X 



960 



S&CCr 'STAffT CLU5IER IMeiON 



I 



FIG. ICd 



dmjog asks 'mgw. at 
rqoctor botw* . seiejt botti 
a»> £)(eoute owj06 



FKi 71 



300CI0: <EP 0632382A1TI_> 



124 



£P 0 6:^ 362 A1 



Pngt Bffitw A?^TCR Making «I1 d.«fllK-#d ehAng*fl. 



InslWill 

RBHDVft input fll* a^tar lii£t.Allatloni7 



IBUl] 



no 
yop 



Esq ^6^?inn<and 



Bsc4 7»Srilt 



F4-Li»t 



FIG. Ba 



B^lPTmhBB -to 

Kov« ci'ux'v«r' to dAsix'fld i.t-»B «nd pr«sfl ^7.- 

QNE OR MORE Itenv aan b« selectod. 
Pr«ss &nt«r hFTl^ aisikiii^ all s«Icct.i<HLS-. 



t toei 











■a 













r J f . rml . ob j QO . 17 . OOOD . OOOO 

f 4ll«nDt« Services PAci.llti«s} SoflLUAr^, R 

[ft«aSB.. .21] 



EffQ^OiiBMlt 



FIG. 8b 



lidd M, Bquz>c« 




TVpd ox* val*ct. valtiAS In entry fie Id r. 

?reiv fSnt;oz^ APTA m^kLnij aIL a«AlT«d efaeitges. 






1 Entry rieldsj 


TVP« 1 
CL««nt.iJt« 1 
{'♦^oK^ihe 1 
In it±BLliza^ion rile 1 


I? } 

i-dAvl 


FlvHttlp r2-^e£reflh 72m^MMieml 
BB0^5ahid.& exe«6^oiniinad SBo*7wEdir 
tt^^^Sh^ll E»«^40-|Eic>.t ^nfcer^tt 





FKj. 8c 



NSDOCia <EP 0632382A1TL> 



125 



BP Q &32 3A2 Ai 



TypQ or £BlOi2t val^ii>v In entry £l^I<^«. 
Proar Eittor AFTGR Making nil c}i*ngAz. 



IhirAtiXon El-day) + 

K^vpouM [2Q] t 



IvfiC«5*"UI)do ♦^C^iuftBJidC Escf^TaBdit SiCi«0«lM^C* 



FIG. 6d 



Kunrv cur-s-oz* t:i> doslred llcm and preav E3»t:«i~.. 



CAll4i%it. Tuaing 



F3«R«£r«ih r^i^^n^-^l c««4«'Jk*9« 



FIG, 8e 



Hdv« eursox to da»lT^Bid lt«M and prass Entfiz*. 



BRC Phono HuKb«rv 



F3-R*£r*«h rjNC#»a«r#l ^c^9-XB'4« 



FIG, at 



ilXXID: <EP 06323e2AlTl_> 



126 



EP 0 632 3a2 A1 



BBC PHcna fiuivhara 




HoVfi atir»Dr tie <l€six«d lt«w «n<{ proas E7it.«r. 

Add M TOC ih<^ Vfo »»t«L" 
Solat^ « she; f1ieiv« MMb«r 






Evo^d^Xsiage 


FIG. 89 


-Add M B>ll£ PhonA Ihisibikr 




Typ« or- w^X^cK v«.Iui4« In «rttje-y ti^ldfl . 

Qn.t.er ArTXH Ji«klt]9 all deiired •rhflngiir.. 






FIG. 8h 






rrass BnL*r AFTTIRL hoekibg «li ^'Ofrir'Ml ahui9«v. 

Qp^r^A^-QT FhG^« number 
Byst^N PhOffi» eruiiib«r- 

1 TfV Palis 


nabn Join**] 

TSM) 555-3325] 
7d«v/t:l:yl] 


Esc+3*Bb«lL E«c40*6vt^ Fi^t^if^o 




FIG. ei 



SOCX;iD: <EP_0632382A1TI_> 



1£? 



EP Q A1 



Hov« cursor t.o desired LLom an J pr«flfl Cnl«3^. 



FZKk«fr«flh 



no. 8J 



HoVa ourior to dcKlrMt lt:«n. and jiress Ont.ar . 



tilrrt UK b:^t Jin?: 



Add OK SLring 
^aletA Ol£ Spring 



Fl«kK*At^ r2^Ra£T«ffh rS-Cuio^l Ee>c*^IiMg« 



FIGl 8k 



Add m StrlAQ 

Tyr« or «<«I«ot V4l4«B in entry fields.. 

Pt^BB Co^oe- AF7SP. makLnq All B«sirod oh^n/^em * 



BM^SaUndo Boc ^SoCoraAnd e;so«7*Cd±% E^^('3>K*g« 



FIG. 61 



5DCXID: <EP 0632382A1TL> 



12S 



EP 0 632 A1 



Kovo owcvflr t.o <i«siJLT<id i-t.*!!. and pi?«i]r £nt.«z-. 



Oal4t« Coim«a^ Strina 



RGw 8m 



Add Ccinn*a't- S'trlng 
rr««« CTi^«r AFTER MsJcing ail dc^lircd chati^e-r. 



C'ltinoL-t. SIT Ari<| 



lEntxy Fields] 



P3>MCBaa»i 
E«rO*'?*-tdit 



FIG. 6n 



Typ« OCT 9«IwL v^Xn^ In *nt.iry ^IfiXda. 

9£Mrs Enl:«r AfTlCfiL M^kita? •IX ^b^rtg**. 



Cai'Ibact ConditlDn fiti^Lag 



9t.a» Bi%a 
Purity 



laffDip 



EMt«r>i90 



f Entry Fl^ldfl] 



• 



FIG. 6o 



ISCXXIID: <EP 0632382A1TI_> 



12fi 



EP 0 ft32 3fi2 A1 



CollamL Had g«f «tf «n.t 



S3i<i-ir C-allout. HAnM«r StAtvis 

Cl«<*n9V / Shov CaLIouI: ManP9«r -St-Atitx- 

filxplav Callout E«ic<>rdE 



rlHI«l{ 



FIG. 8p 



DiLAiiga / Fhow C*H^it K^Vt*tI«r SUAtM* 

Typ^ -wr- £Bloct. valves In cn^rv fields-. 

ProiriF Ea'bBK- AFTER a-alring all dc-slrcd cb<a7ig«v. 



120] 



Eacr*7"EdXt: 



no. 8q 



Ptvvr fint«r ASTEft MAking aJI d^slrad c}ia»g«fl. 



aiBSiB 



FIG. Sr 



30OCID: <EP_0632382A1TI_> 



130 



£P D 6:^ 3d2 A1 



CDnflquz-B CAllOLIt. (CitiJt*?; CXi«ikt} 
H«v» cur J or to d«jlj;r«dL ^nd pv^ta.^ E^btar-. 



' V?; •'.ciii i rl ml: ] fj 



F^icCAiba ml 



FIG. 8» 



Zypc or ff«l«et. in «ul;x¥ fi^l^lv. 

P2^flM^ BiLt«r AFTCH ftAkUoi^ All dMir«<t chjoig^Pr 



r Attar Pb<in« Suinber' 



I entry rtcXdv) 
[Pom d. jr«n««] 

[TC9t| 



na at 



SOOCID: <EP 0632382A1TI_> 



131 



EP 0 632 3B2 A1 









M[>v« cursor d^Jik-^ it-*" *Jvd [ijr^fldr Eh1;«c. 






Configure K^f4 It'Mtljtfl 












FIG. da 








tr«»a Cntor AFT'ES >iAkJ.ng all desired cJijickj«s, 






All^U Boot grlvl tigai: 


[Entry rield«I 
Qisablod 






P4-aiat: 
Eac-f <Kla«g« 












Fran 8k«t«r AFTEI MklAg nil d^rU^*^ <6b«n0«ri . 






E-mnli on Call-in 


rRntiry ^i#adaj 
[ /dav>conaoX« | 

[j 

I root.] 
[vt,10C»] 


4- : 

4 
4 




FtaLlat: 
Eav^^aalBAig* 




PK* 9c 



3CXDCID: <EP 0632382A1Tl_> 



132 



EP 0 382 A1 











S^flrt Ciust.iir bB.«ft.o<ji 
CM$t>l«v ft«cord of Jlctioiifl 









FIG. lOo 



Cuffi figure D 1 aqiios (.Ic 






lypv or »«Iflct Y-aluQV In ontry fields. 

er>«4p ent^ A^TER naklng All doslrc^ cH^ngca. 








iMOimiiLic] 


+ 
4 


E«e49i^Sh»il Sec 4-Oa Exit Bnt«r«Oo 






FIG. JOb 


SbMJTtt MF Dmirmoa 






Tyi^ tat fefli«at. v«Xu«9 in An^rv 

Pr^fttf Cnt^r AFTER MkJLng #11 dtt^lr^ Cr1»«ng««. 








tEn^vy Fi«ldB2 






♦ 


Sao^SflilMo Eae f^fi^om and toc+T^&dlt: 






FIG. tOc 



EP G ftdd 3B2 Ai 



Iwf-tt or floJlflct vaLu«s in entry fialdg. 

Presff Bntar AFTEP.. linking a 11 dcslrftd ch*n9«fl. 



(Kitrry Fi«Lds| 



na lod 



BP 0 6^2 362 A1 




FIG. llo 



EP 0 ft32 3B2 A1 



START 




SETUP 
fRfl. 11c> 



1100 



WAfT FOR 
NEXT EVENT 



I 



.1102 



GET EVENT 



I 



.1104 



SCHEDULE 
NEXT 

OCCURRANCE 
pF THIS EVEMT 



I 



1106 



DISPATCH 
BASED ON 
EVENT TYPE 



nio 



1107 



CLEAN 



I 



DONE WITH 

EVE^rr 




1114 



FIG, lib 



EP 0 632 :M2 A1 



T 

OPEN SOURCE 
ATTRieUTES 
DATABASE 



1 100-2 



1100 



IILI 

THERE ARE 
JKRE UNREAD 
lECORD 



1100-4 

NO MORE 



1100-6 



READ OlAGMOSTiC 
CONFiQURATION 



MORE 



1100-10 



?EAD RECORD INTO MEMORY 
BUJLD INTERNAL LIST 



DIAGNOSTIC 
ENABLEQ, 



END 



1100-12 



USE SEARCHTIME TO 
SCHEDULE A SEARCH EVENT 
f^OR THIS SOURCE 



I 



Ty tioo-& 
♦ / 


USE DIAGNOSTIC 
f REQUENCV TO 
SCHEDULE A 01 AG 
EVENT 







1100-U 



USE CLEANTIME TO 
SCHEDULE A CLEAN EVENT 
FOR THJS SOURCE 



RG. No 



EP 0 6S2 A1 



PBC ubsMXSly^ 
FROM IflG nil ^ 



11K 



HO MHS 




WE SOURCE nPL TO 
OEIERUNt mi 
llOt/ntf TO ML 10 



Iioe-B 




U5£ SOURCE tnt 10 
DE1ERUME W 
ROOmE HO Cfti 10 
SEWCH WE. NESSMjE 
ICMPIATE RKTWSl 
FDRAMTCH 



US RGGUUB 




(i«£ ERROR ID 



no8-w 



1106-22 




EXECUIEACnX 
R)R SOURCE 



FIG. Ikl 



BP 0 632 363 A1 




EP 0 632 302 A1 



QUEKir 
TKTt TO BF USID 



12« 




12CG 



.BEEN Sn 
7 




/I 



I21U 



SETIERU miRO^ 

TO c€r*ujor vrico 



1112 




i213 



I 



PDft tfrOCft OfR MOT 
dRftrt-TO-TEMlUC 




1224 



UHE: MO MKUIEHTS TO 
IGEWM. yCMimHC 



1Z2£: 



MSG JfMJhQ^TD 



EHUH Mi^cflipr urn MEni- 

ICrrSTQ BUH CMS WIH 

iV9cM«KTs CM ajir 
mum) uHi 



HD SCRP1K OPTRK 
KMC SCEN Sa£CIQ) 

« iicisr ajn Gins 



FIG. {23b 




1242 



SQCE-IMLID 
MtWa wnFt- 



EP 0 632 sad A1 




1250 



DOREMOTE RUNS AS A 

SETUID PROGRAM TO 
OBTAIN SUPER-USER 

PRIVILEGES 



1252 



EXAMINE COMMAND 
LINE TO DETERMINE 
WHICH PRIVILEGED 
TASK IS REQUESTED 



I 



1254 



QUERY CONFIGURATION 
TO DETERMINE IP THE 
TASK IS ALLOWED 



1256 



sTASK ALLOWED'^ 
Jn 1258 




1260, 


PRINT PERMISSION 
DENfEO ERROR 
MESSAGE 




PERFORM 
THE TASK 









END 



RG. 12c 



EP 0 632 











R^Ot Log 111 









FIG. 12d 



EP 0 632 382 A1 




EP Q 63i 382 A1 




PARSE COMMAND 
LINE ARGUMENTS 
BUILD LISTS OF INPUTS 
AND OUTPUTS 



1302 



START SUBSHELL 




FIG. 13b 



£P 0 632 382 A1 



1350 



CHECK FOR 

CURReiMT 

SESSION 



1352 
>OfS^-C^ N 
THE CURRENT 
SESSION FILi 
EXIST 



L 



1354 



NVOKE SHOWSCRIPT 
IWITH CURRENT SESSION 
FILE AND PiD FROM 
RID FILE 



1356 



DISPLAY 

INFORMATIVE 

MESSAGE 



FIG. 13c 



EP 0 632 362 A1 



1360 



PARSE 
COMMAND UNE 
ARGUMEMTS 



I 



1362 



READ FROM 
SESSION RLE 
AND WRITE TO 
TERMINAL 



1364 




1370 



^1366 

was"" 
pid specified 

m COMMANa 
JNE? 



1372 



N 



HANDLE OTHER KEYS 



13G8 



SEND KILL 
SIGNAL TO 
PID 



CLEANUP 
AND EXIT 



"17 

Tend j 



1374 



na i3d 



This Page is Inserted by IFW Indexing and Scanning 
Operations and is not part of the Official Record 

BEST AVAILABLE IMAGES 

Defective images within this document are accurate representations of the original 
documents submitted by the applicant. 

Defects in the images include but are not limited to the items checked: 

□ BLACK BORDERS 

□ IMAGE CUT OFF AT TOP, BOTTOM OR SffiES 

□ FADED TEXT OR DRAWING 

□ BLURRED OR ILLEGIBLE TEXT OR DRAWING 

□ SKEWED/SLANTED IMAGES 

□ COLOR OR BLACK AND WHITE PHOTOGRAPHS 

□ GRAY SCALE DOCUMENTS 

□ LINES OR MARKS ON ORIGINAL DOCUMENT 

□ REFERENCE(S) OR EXHIBIT(S) SUBMITTED ARE POOR QUALITY 

□ OTHER: 

IMAGES ARE BEST AVAILABLE COPY. 
As rescanning these documents will not correct the image 
problems checked, please do not report these problems to 
the IFW Image Problem Mailbox. 



